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N ow, through a joint 
development agree¬ 
ment, Symantec and 
Apple '* Computer let you 
produce the fastest Power 
Mae code* 

Symantec C++ for 
Power Macintosh™ now 
comes with MrC- Apples 
new optimizing compiler. 

Industry-standard 
Nullstone tests show that 



•Sytn&riieoC- h ■ 

with MrC 


SymMek C++ Metfswerks 

CcxteWamor 7 


Code compiled using MrC mm an atvmge of22% faster than arde compiled 
with the standardSymantec C++ compiler or Memmvrks Code Warrior 7 1 ?* 


size and color* Organizing 
and navigating a project 
has never been easier. 

In addition, Symantec 
C++s multi-threaded envi¬ 
ronment gives you die abili¬ 
ty to edit and write code 
while you compile* And 
our visual architect lets you 
quickly draw the interface* 
Corresponding code is then 
generated automatically. 


when MrC Goes to work, 
Symantec C++ applications Get 22% faster. 


applications compiled with MrC 
run an average of 22% faster. 

Develop Faster 

APPLICATIONS FASTER. 

Not only can you develop the 
fastest Power Mac applications, 
you can write them fast, too. 
New AppleScript support lets you 
automate repetitive tasks. While 
the new linker provides fasr turn¬ 
around for incremental Lxiilds. 

With the fully integrated 
class browser, you'll quickly nav¬ 
igate your C++ class library* 
And support for templates and 
multiple inheritance further 
boosts your productivity* 

Organize And Manage 

PROJECTS EASILY. 

The new Project Manager 


lets you organize and manage 
nested projects. You can 
display hierarchical 
groups as folders within a 
project window for easier 
organization. 

The editor gives you 
unlimited split panes and 
full text formatting- font, 

MrC Compiler 

pm times the fastest Power Mae applications 

AppleScript 

automata the buildptvcm 

New iNCki mini al Linker 

provide* fast imrrmrtittd builds 

Tempute And Multiple 

Inw.iutanceSlwort 

increases productivity 

Nestcd projects and Folders 

let you organize and navigate projects 

Multi Threaded 
Environment 

Iris you edit and unite code ivhile compiling 

Visual Architect 

builds your interface visually 


All in all, Symantec C++ is a 
great way to develop the 
fastest applications for 
Power Mac. 

THREE CDS FOR THE 
PRICE OF ONE. 

When you register as a 
Symantec C++ owner, 
you'll he enrolled in the Symantec 
C++ Subscription for Macintosh 
program. Subscribers will auto¬ 
matically receive two free prod¬ 
uct updates (on CD ROM) so 
you 11 always have the latest fea¬ 
tures and tools. 


Learn more about Symantec C++ on 
the Internet at tt>wuKsy mante(, com 
Or call I -800-628-4777. Extension 
91122 for more information. 
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Building Internet And Other Native PowerPC 
Applications Has Never Been Easier Or Faster. 


SmalttalkAgents® 

SmalllalkAgcms (STA) Ls a 
snphisticaicd rapid applica- 
tion development environ¬ 
ment based on a new gen¬ 
eration of the Smalltalk lan¬ 
guage, enabling you to easily deliver double- 
clickable applications. 

Copland Style GUI Look & Feel 



design anti project elements in a “Finder- 
like" desktop workspace as fluidly as you 
work with folders and documents on your 
desktop. Interactively build, wire, and inter¬ 
connect reusable components and inter¬ 
faces in an integrated environment. 

GUI Design ft Generation 

live “Drag and Drop” manipulation to build 
your application’s visual interface using 
components that “know" how to behave 
and autoconfigure themselves into an envi¬ 
ronment. Create new components and/or 
wire together existing components that can 



be saved as reusable template designs for 
use in other applications or containers. 



rtecn&Ohjcct Swam 

MACINTOSH 


Creating professional quality’ user interfaces 
Ls easy with our component parts libraries. 

VisualWorkbench 

Visually manipulate all objects including 
source and design dements using your 
mouse and keyboard. Visually manage 



DTP Engine ft Word Processor 

STA not only includes a programmable 
won! processor component and 
HyixtrMedia engine, but also a powerful 
report writer that supports embedding of 
any kind of objects, movies, Hows, and 
international text, and page layout. 

C/C++, Pascal Workbench 

Compile, edit, and dynamically link C/C++, 
Pascal, fortran, and Assembly axle directly 
from within our STA VisualWorklxmch as an 
integrated part of the Smalltalk application 
development prix'ess 

Component-based Architecture 

STA components are designed for OpenDoc 


and OI K, anti will give you transparent inte¬ 
gration will) 0|x.‘ttDtx - and OLE when they 
become available. 

Threading ft Internet Tools 

STA provides powerful sup|xm for Internet 



server as wdl as client tool development. 
Pre-emptive threading, thread safe libraries 
and classes for TCP/IP pit ttocols arc stan¬ 
dard features enabling you to quickly and 
easily deliver custom e-mail, WWW, list-serv¬ 
er. and other dial-up/network related apps. 

PowerPC Support 

STA provides binary’ |X>rtabiiity across differ¬ 



ent CPUs and Operating Systems. Design 
applications ttxlav on one platform and sim¬ 
ply deploy on other platforms as required. 

Contact us about our Web Server & 

Client Toolkit at l-HOO-296-1339 or at 
<info(3 qks.com > or visit our VR*b site 
h tt p :,Avw w. < | kscon v . 

Quasar Knowledge Systems, Inc, 

9318 Parkwood Drive 
Bethesda, MD 20814 USA 
Tek (301)530 4353 Fax: (301)530-5712 



© Quasar Knowledge Syeiems. Inc, 199S All rights reserved. All other brand or product names are trademarks or registered trademarks of iheir respective holders 
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By Neil Ticktin, Publisher 


[Scott > taking a much needed break this month from his 
Viewpoint column - he’ll be Nick next month unth more insight 
and comments on our industryJ 

Thf Psyche of “Real* Computer Users 

I recently attended Comdex, and now, besides wondering why l 
took the time to go to the show, I find myself making some 
interesting observations about the computer industry - and more 
importantly, the psyche of computer users. 

late this past summer, the Fed T s favorite target of anti-irust 
investigations released Win 9^, And with all the hype, even the 
most stout of heart in the Macintosh industry had to wonder: “Can 
the Macintosh survive?’ 1 

t don’t dunk dial most of us believed that Wm95 could kill 
die Mac OS (especially with \Vin95 .sales projections dropping 
nearly 50 %} t hut a kit of us were looking lor the deeper reasons 
as to why we felt dial way. For over a decade, Mac users have 
have had an easy answer to this question - other systems 
simply lacked anything resembling a real user interface. And 
even though, as the bumper sticker says, ,l Win95 - Mac l 89", 
many people still believe the perception that Microsoft wants 
them to - that Win95 is as gtxxl as a Mac. And while the Mac 
QS is still superior in many ways, it has become tougher to 
explain to Windows users why we use Macs - and why we 
won’t "just convert to using Windows.” 

As Win95 shipped, I recall actually hypothesizing: “What 
would it he like if the Mac and Apple ceased to exist, and 1 was 
forced into using Windows?” My conclusion was that 1 would 
likely reduce the number of things that i used a computer for - 
i would turn to PDAs whenever 1 could. Why? Simply because 
i don't enjoy using Windows and 1 would want to minimize my 
exposure to it. Would you want to spend more or less time 
with a "friend " you didn’t like? 

I also concluded that FDR’s “the only thing we have to fear 
is fear itself is quite applicable at this time to die Mac side of 
our industry. 

Back to my Comdex thoughts... 

Walking around Macworld, 1 see lots of animated faces - 
people are excited about cool technologies, and are even 
irritated when lliey don’t see enough cool things. And we 
know why - Macintosh users have bonded willi their machines. 
It’s more than seeing neai things done on the computer - 
they’ve integrated the machine so completely into their 
thoughts, that their Macs have become partners, not just tools. 

PC users, in general, are different. While there are a great 
many exceptions, ihe “bond quotient" per computer is far 


higher on the Mac side of the industry. As I looked around 
Comdex, the faces of all the people were so serious looking. 
They appeared bored and overwhelmed. 1 don’t remember 
seeing a single excited face (except for when they were 
watching the mimes at the front door), 

1 also took note that Comdex was a lot less about 
technology and what computers could do for you, and a lot 
more about marketing, flash, and sales tactics. Sometimes, we 
forget how different the Macintosh and Windows worlds are. 
For example, we know of one company that used their highly 
successful Windows product marketing approach in the 
Macintosh market - only to have it fail so miserably, it may 
have l>een better to do nothing. Food for thought. 

Bui what does this mean, Neil? 

The IxXtom line is this. In general. Windows users don't 
view their computers in ihe same way a Mac user views a 
Macintosh. Mac users have so bonded to their machines diat 
they almost go out of their wav to find new ways lo use the 
computer. Mac users like their machines - Windows users think 
of their computer as a box they use. And until Microsoft figures 
how to create this kind of relationship lietween PC and user, 
the Macintosh is still the superior user interface and product. 
By the way: I don’t expect thal Windows users will "get” this 
argument - if they did, they’d use the Macintosh, 

Save Cyberdog! 

Apple has been working on a set of Internet tools based on 
Open Doc. While this product will probably end up named 
.something like "OpenDoc Internet Client”, its axle/commonly 
known name is Cyberdog, which comes from a New Yorker 
cartoon showing two dogs at a terminal, where one dog looks at 
the other and says 4, On the Internet, no one knows you are a dog." 

Unfortunately, there seem to lie some trademark issues for 
the use of the Cyberdog name, It also may be the case that 
Cyberdog isn’t as “professional" a name as the corporate types 
may want. But, do Mac users want professional? or do Mac 
users want cool, fun computers? 

Want to do your part to save the "Cyberdog” name? You 
t an. Send e-mail to save-cyberdog@mactech.com. We re going 
to compile the comments and pass them onto Apple, so even if 
your message is short and sweet, your vote will be counted 
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had) year, the illegal use of software 
consumes nearly 50% of your potential 
revenues. With the flames of piracy eating 
away at your profits, can you afford not to 
protect your software? 


Software Obtained Illegally, by region, 1993 vs. 1994 


Afrca Mkfdhr last 

$666,440,106 

392.687.055 

$3,963,527,364 

Asia 

4 350.901 640 

$4,900,302,960 

Europe 



$021,992,?51| 

Latin America 

1.334594.665 

U.5JCanada 

$2,487,360,944 

3.131,456,600 

Total for 1993: $12,840,204,124 

SI 5.212,700,215 

Sodice USA 


MacHASP* 5 is widely acclaimed as the world’s 
most advanced software protection solution 
for Macintosh computers. Since 1984, 
thousands of leading Mac and PC developers 
have used over one million MacHASP and 
HASP keys to protect billions of dollars worth 
of software, Why? Because MaeHASP’s 
security, reliability, and easc-of-use led them 
to a simple conclusion: MacHASP is lire most 
effective software protection system available. 



Today, more developers are choosing 
MacHASP than any other software protection 
method. To learn why and to see how easily 
you can increase your revenues, call now to 
order your MaeHASP Developer's Kit. 

1 - 800 - 223-4277 


ALADDIN 


The Professional's Choice 

North Al add i n Software Security Joe. 

America Td: (800)2254277,212-5645678 

Fax: 212-5643377 
K-nudJ. salcs@hiksp.com 
WWW: liUpi/Avww, hasp.com/ 

Inti Office Aladdin Knowledge Systems Ltd. 

Tel: 972 .V537 5795. Fa* 972-3-557 5796 
H ri ai E: ahiddiri @al add i s 3.c&iI 

United Aladdin Knowledge 

Kingdom Systems UK ltd. 

Td: (l l 755422266. b'm 01755-622262 

France Aladdin France SA 

Td: 1 4085 9885, fax- 141 21 56 
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Power Too Abundant to Meter 
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Powerful 

NeoAccess and NeoShare are the most powerful 
object-oriented database engines available. They 
display electrifying performance—up to ten 
times that of competitors. Behind an elegant 
programming interface is a high performance 
querv engine utilizing; extended Dinary trees 
and binary search algorithms tuned for short 
access times, dynamically combined, collapsed, 
and compressed indices, and object caching for 
lightning fast access to previously used objects. 

No Runtime Fees 

Get the power of NeoAccess and NeoShare, and 
avoid the expense and administrative hassle of 
Feeding the runtime fees meter. You pay one 
affordable price no matter how many copies of 
your application you sell or use. 


Cross Platform 

Others may promise cross-platform 
development tools—NeoLogic delivers. 
NeoAccess is a set of C++ classes designed for 
use with popular compilers and application 
frameworKs on Windows-. Macintosh®, and 
Unix 1 " platforms. Full source code is included 
so it can even be used with custom frameworks. 


New in NeoAccess Version 4.0 

NeoAccess now supports Microsoft Visual C++ 
4.0 IDE, MFC 4.0 and the latest version of 
Metrowerks Code Warn or. A new stored query 
class increases speed and flexibility in accessing 
objects. Inverted indices and full word search 
capabilities ease working with many-to-many 
relationships. And all new on-line Hyper- 
Reference guide, documentation, tutorial, and 
sample applications get you up to speed 
and provide a complete set of reference material 


Scalable 

NeoShare extends the core features of 
NeoAccess to client/server applications. 
NeoShare includes ihe NeoAccess Toolkit and 
everything you need to create data intensive 
distributed applications. Its advanced 
client/server architeciure provides shared access 
to objects by multiple networked clients. 
Combine client and server functions into a 
single application or create separate client and 
server applications. With NeoShare you have 
complete flexibility in the design of your 
disiribuLed systems. 


Proven 

Thousands of commercial and in-house 
developers have already found that NeoLogic’s 
technology enabled them to build fast, 
powerful applications in record time. That’s 
why NeoAccess and NeoShare based 
applications are already operating on millions 
of computers. Tap into the power for your nexi 
development project! 


neo-logic 


Powering Development of Object-Oriented Applications 

NeoLogic Systems *450 Fourth St,, Suite 12 V. 510 . 524.5897 

neologTc@rteoiogEC.com Berkeley, CA 94710 f. 510 . 524-4501 











PowerPlant and Commanders 


I his month } we’re going to explore a 
brand new aspect of PowerPlant: the 
concept of commands, commanders, 
and the TCommander PowerPlant class, 
PowerPlant commands are similar to 
messages. You’ve already seen how 
messages are sent from a broadcaster 
(such as a button) Lo at! listeners 
registered to listen to that broadcaster 
The command model is slightly different. 

Commands are associated with 
menus and key Down events. To 
respond to menu selections and user 
keystrokes, you'll need to create a class 
derived (at least in pari) from the 
LCommander class. There are three key 
functions you II inherit and override 
from llie LCotnmantier base class. 

• Handle&eyPress() - receives an 
Event Record containing a character 
typed by the user. 

• ObeyCommand ( ) - receives a 
command number associated with a 
specific menu command. When we 
create this month's project, you'll see 
how to associate a command 
number with a specific menu item. 

• FindCommandStatus () - gives 
your hCommander subclass a chance 
to update (i.e. enable, disable, 
check, uncheck, change item text) 
the status of the menu item 
associated with a specified command. 

Basically, PowerPlant handles the 
administrative work of keeping track of 
which menu items need to be enabled, 
which pane should receive which event, 
etc. Every PowerPlant application has a 


chain of command. The chain (really a tree) starts with the 
LAp pile at ion object and flows downward through other objects 
that handle commands to the panes that will become tire targets 
of the commands. Think of the current target as the application's 
current focus. If a keystroke is entered, the corresponding 
keyDown event will lx* sent to the current target pane (perhaps a 
window, perhaps a textEdit pane within the window). 

As you'll .see in this month's program, youll have a little 
setup work to do, and then you II override I lie ihree 
LCommander functions described above. That's pretty much it. 
Of course, as you get deeper into PowerPlant youll discover 
that there is much more you can do, but for now, concentrate 
on understanding the basics. 


A Sneak Preview or BiiiipCoivLMANDLR 

This month’s program is called BeepCommander It features a 
single window type that responds to key Downs by displaying 
the typed character in the window. Figure 1 shows a 
BeepCommander window. 



Figure 1. A BeepCommander window. 

BeepCommander also features a menu named Special 
with a single item named Beep. When you select Beep, your 
computer beeps (gasp!). The sneaky thing is, the Beep item Ls 
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only enabled when the letter l x + is typed, J know, 1 know, 
weird user interface. That's line. The point is to show the 
relationship between menus, keystrokes and the LPane and 
LConmander functions you'll be overriding, 

Let’s get started 

Create a New Project 

The first tiling you’ll need to do is create a new project, based 
on the PowerPlant stationery. 

* Create a new Folder ca 1 led ReepCommander. 

• Launch Code Warrior and create a new project named 
BeepCommander.g. 

* In die project window, double-click on the file <PP Starter 
Resource) - rsrc, This will c.>pen the File in Ginslmctc n. 

• In Constructor do a Saue As... and save the file in the 
Beep Commander folder as Beep Commander . rsre. 

(This Iasi step lulls Constructor to completely duplicate the file, 
and not just the resources it uses. This is definitely the right 
way to replace the stationery resource file.) 

* Quit Constructor and return to Code Warrior. 

* Add the file BeepCommander. rsrc to the project, 

• Delete the file <PP Starter Resource).rsrc from the 
project, 

• In the project window, double-click on the file <FP 
Starter Source).cp, 

• Select Satie As... from l he File menu and save the file as 
BeepCommandcr.cp. 

Notice that the stationery file name changed from <PP 
Starter Resource),rsrc to BeepConmtander, cp in the 
project window. You might want to dog-ear this page and refer 
back to it the first few r times you create your own PowerPlanL 
projects. Tfie.sc 1 first nine steps make a good starting point for 
all your new PowerPlant stationery-based projects. 

Creating the Project Resources 

Your next task is to add a new menu to the project sind 
associate a command number with the menu's item. 

* Launch your favorite resource editor 

Be sure you install the appropriate resource editing templates 
for your resource editor. You 11 Find the files PowerPlant 
Resorcerer TMPLs and PowerPI ant ResEdit TMPLs 
buried in subfolders within the Metrowerks CodeWarrior 
folder. To install the Resorcerer templates, drag the file 
PowerPlant Resorcerer TMPLs into the folder 
Resourcerer® Templates. To install the ResEdii templates, 
duplicate ResEdit, then use ResEdit to edit the copy. Open the 
file PowerPlant ResEdit TMPLs and copy the 1 TMPL T 
resources into your copy of ResEdit. Your copy now has the 


templates installed. As always, keep your original around in 
case things get screwed up. 

* Select Open... from the File menu and open the file 
BeepCommander.rsrc. 

* Create a new 'MENU 1 resource. Change its id to 131 (be 
sure It gets changed in both places if you are using ResEdit). 
Give the new menu a title of Special and create a single 
item called Beep. If you like, give Beep a command-key 
equivalent of BGB 

* Create a T Mcmd' resource, also with an id of 131, Add a 
single item with a command number of 1000. 


The 1 Mc.md 1 resource you jusi created associates a command 
number of 1000 with the Special menu’s Beep item. 

Figure 2 shows the hex version of this resource in KesEdit in 
case you ain't get your T Mcmd' resource template working or 
if you just want to check your handiwork. 


=m Mcmd “Beep” ID = 131 from bee 


oooooo 

000008 

ooooio 

000013 

000020 

000028 

000030 

000033 

000040 

000048 

000050 

000058 

000060 

000068 


(0001 0000 03E8 


DDDPQO 


i. 




Figure 2. The hex version of 'Mcmd* * 13 i 

• Modify 1 MBAR■ 128, adding the new 'MENU' id (131) to 
the list of other ’MENU' ids already in the resource. 

• Save your changes and quit your resource editor. 

Constructor 

Now well use Constructor to create the views well use in 

this program. 

• Back in Code Warrior, double-dick on the file 
Beep Commander. rsrc to open the file in Constructor, 

• In Constructor, delete the existing “<Replace Mc>" view. 

• Select New Resource from the Edit menu to create a 
new view. 

• Wh en t he N ew Resou rce dialc)g appea rs, type Single Char 
IB in do w in the texlEdiL field, be sure the popup menu is 
set to LUlindow. then click OK 

• Close the new view window. 

• Be sure the new view^ is highlighted in the master view r list, 
then select Resource Info from the Edit menu. 
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AppMaker 

Your Assistant Programmer 

AppMaker makes it fast and easy to build a user interface. Just point and click, then 
let AppMaker create resources and generate source code. AppMaker generates 
excellent source code for most popular languages and frameworks. 



Title; [^Rgmindgr 

vtrmn ■ TTq 


Bn 


Cancel 


File F flit Uieui Options 


$ 


field 


M enii «* r 

Pa . fe; 


Time: | 


Qrh 


When remindi ng. Q Display k on 

□ Display aifi t 

□ Play Sound: J 


HMHemuide 


▼Applications 
ANRemi rider’ 
▼Class Defs 
▼ Rem inefer Entry 
date 
time 
message 
ornPrn 
shdwlcon 
showAlert 
playSounc 


Application Info 


Cj- eator Type: lAMRm 
Ffle Tin*: lAMRD ~ 


Copyright; jjp 1 995 r Bowers Developfinent ] 
Startup Acttau; | Open document ^~| 


Extremely customizable and extensible—The source code generator, the resource 
generator, and even AppMaker’s own user interface are all soft-coded so Lhal you can 
easily tailor AppMaker to meet your needs. 

Designed for portability—A single AppMaker document can now generate code and 
resources for a wide variety of languages, frameworks, and eventually, platforms. 

Supports Code Warrior Power PI ant, Neo Access, and PowerMac development. 

New features include Drag & Drop, outline view, simulator, and support for color. 

Includes one-year automatic update service with at least three CDs per year. 


B • O • W • E « R • S 
Development 


97 Ixiwell Road, Concord, MA 01742 • (SOB) 369-8175 • FAX 369-8224 
CIS; 70731,3710 * AOL: BoweisDev • AppleLink: DI72I 






























































From idea to delivery... 



Complete 

Software 

Duplication 

Service 


all handled with top 


Autkiie(lA| , ple% iicjior 

For 11 Years! 


International Datawares, Inc 
227 H Truck- Zone Blvd 
San ]ose * CA VSliSJ 
( 408 ) 262-6660 
Fax: ( 408 ) 262.8906 
1 nit men idikds@aol.com 


QVAIJTY .., SERVICE ... SPIUID 


Software Duplication ♦ C'l) ROM 
labeling ♦ Assembly 
Frinling ♦ Packaging ♦ Shipping 


800 - 222-6032 


* When the view info window appears, change the resource 
id to 1000. 

* Close the view' info window. 

* Double-dick on the view name in the master view list to 
reopen the view editing window. 

This view represents our main window, the window that will 
be t reated when you select New from our application's File 
menu. We re now going to add a pane to the window that will 
he reflected in our source code by the class 
CSingleCharPane. Just as a heads up. CSingleCharPane 
will be partially derived from the LCommander class and will 
be the target for both menu selections from our new 1 MENU 1 
and for keystrokes. More on all this later. 

* Drag an LPane from the palette into the center of the view 
editing window, 

* Double-click on The LPane to open a pane info window. 

* Set the Location coordinates according to those shown in 
Figure 3« 

* Check all four of the Binding to Superifieiu 

checkboxes, keeping the pane proportional to its enclosing 
window. 

* Change the Fane ID to 2000. 

* Change die Class ID to Cindr. 


This last step is extremely important, The Class ID is what ties 
this view resource to the CSingleCharPane class we ll define 
when we get to the source code, by the w r ay t just as Apple 
reserves all lower case resource types, Metrowerks reserves all 
lower case Class IDs (for example, 'abed' is reserved, but 
’ Abc.d T is just fine). 

* Save your changes and quit Constructor. 


Into for LPane ID 20U0 . 


U«:k 1 Width; jjoo 

1 Height : [200 1 


S Top 

^ Lett Right 

Bottom 


Pane ID : |2000 | □ T«rt ID ^ Enabled 

User Constant: |0 ] □ Text constant IS Visible 

Class ID : [Cnrvdr 

£1 _ i£ 



Figure T 7he pane info unndowfor our LPane. 


Adding the Source Code 

Your next step is to return to CodeWarrior and type in some 
new source code. 

* Back in CodeWarrior, create a new source code file, save it 
under the name CSingleCharPane, cp. 

* Type in the following source code: 

if include <LFane,h> 

^include ^Commander.h> 

/^include “CSingleCliarParte.h" 

CSlngleCharFane * 

CSlngleCharPane: rCraatteS ingleCliarPan#Stream( 

LStream -InStream ) 

[ 

return( new CSingieCharPanet inStrearo ) ); 

) 


CSingleCharPane:iCSlngleCharPane( LStream ‘InStream ) : 
LPane( inStream ) 

[ 

mChiitr = ‘st’ ; 

\ 


Boolean 

CSinglECharPane::BandleKeyPress( 

Const BventRocord &inKeyEvent ) 

I 

mChar “ inKeyEvenl.message & charCodeMask; 

SetUpdateComniandStatusf true ); 

Refresh!): 

return true; 

1 


Boolean 

CSingleCharPane::ObeyCommand( Command! ItiCommand, 
void 4 ioParam ) 
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Announcing 

MICROGUARD^ 


Why so many developers are switching to 
MicroGuard copy protection 


• MicroGuard is committed lo uncompromising 
technological superiority 


• MicroGuard has now surpassed its own 

technological lead, actually improving on the best 



'Technology at its peak" is our commitment to you. that ft why we have 
brought you MicroGuard Plus™ And, MicroGuard Plus is 100% 
backwards compatible with MicroGuard. Ill is means MicroGuard 
and MicroGuard Plus can lie used interchangeably. 

Just as we promised! 


MicroGuard offers you the 
most sophisticated network 
protection 

Our network protection, MicroGuard Net r \ 
is so superior, wc had to hire an Apple network 
engineer to execute our specifications. 


MicroGuard is the only key 
developed by Mac 
developers, and is the first 
and only 100% ADB savvy key 


MicroGuard sells murc Macintosh 
ropy-protect ion keys than anyone else 
in the world! 


• MicroGuard delivers 
developer support 
within 24 hours 


MicroGuard Hus is everything MicroGuard is, plus 40-hit encryption, two 
additional passwords* 64-Bit Array, 32 byte public area, 43% size reduction, 
enhanced counter and more, In addition, MicroGuard Plus offers two new 
utilities: QuickC uard* and EasyGuard™ alkwyou to protect your 

applications without touching your 
source ctide, The only feature lhai 
is not plus is the price. 


• MicroGuard is the best 
selling Macintosh key in 
the world 


We have been developing Mac applications as a seed development huusc 
since 19B1 We are not a PC protection company that has come to you 
with a Mac product. MicroGuand is fully ADB savvy anti offers extended 
addressing. Unlike other protection devices, MicroGuard never dashes 
with other keys Only MicroGuard offers this level of sophistication. 


We will answer any inquiry you have within 24-hum We also have a fully loaded 
AppleLink bulletin board which contains all our libraries, lech notes, Q&A and 
nearly everything yuull ever need! 



For more information and tv order a Developer's Kit or to receive a free CD ROM about MicroGuard\ 
pleme contact us at: 

MicroGuard USA: Tel: (303) 320-1628 • Fax: (303) 320-1599 • AppleLink: M.GUARD 

International: Tel: (972) 3 538-2345 * Fax: (972) 3 558-2344 * AppleLink: MICROGUARD MaCf )S 








if { inCommand — 1000 ) 
t 

SysEeep( 20 ); 
return true; 

J 

else 

return LCiMitmrmdnrObey Command UnCommand * ioFaran); 


void 

GSlfigl eCharPane: : Find Coiamand Status ( 

Command! inCommand. 
Boolean frontEnabled, 
Boolean froutUsesMark* 
Char 16 fautMark, 

Str233 outName ) 


1 


1 


if (inCtmunand " 1000) 

oulEnabled = (mChar Q f x’); 

else 

LComnsiirider :: FI ndCmnmandStatus (inCommand, outEriabled. 

outlfceitMark, outMark, outName): 


void 

CSfngleCharPano::DtawSelf() 

t 

Rect frumeRect: 

short x, y, frameWidth. f ratneHeight; 

const shortk FontSize - 128; 

Funttnfo rayFontlnfo; 

CultLoralFrn*eRect( frameRect ); 

frameWidih r f rameRecr. right - frameRect.left: 
FrameHeight = frame Reel; .bottom frameRect. top; 

TextSize( kFontSize ); 

x = {frnmnWidth ■ CharWidthC mChar ))/ 2 
+ fraraeRert.left; 

GetFontlnfoE fernyFont Tnfo ); 
y - frameftect.bottom ({frameKoighr - 

myFontlnfo,ascent + myFornltif o .descent) I 2); 

HciveTo ( x. y h 
DmwCharf nChar ): 


Save your work, and add die file to the project. 

Comments on Singu;CilvkPan£.c:i j 

SingleChar Pane. cp sums off with a creation function. 
Well pass dial in when we register this new class by calling 
URegistrar : ;RegisterCIass (). Notice that die creation 
routine actually creates the C Single Char Pane object* Get 
used to this way of doing things in PowerPoint, 

NexL conies the constructor. Notice that the constructor 
maps the input parameter to the LFane constructor. 
CSingleCharPane is derived from both LPane and 
LCoromandcr, The data member mChar holds the last 
character typed. We initialize it to 'x 1 , since that's the magic 
character that enables the Beep item. 

The function CSingleCharPane: iHandleKeyPress () is 
inherited from the LGotnmander dass and gels called in response 
to a keyDown event. The function returns true if the keystroke 
was handled correctly (in our case, we always return true). 
LCommander::SetUpdateCommandStatus(true) marks the 


menu bar as needing its status updated, LPane;:Refresh() 
forces an update on die visible portion of the pane. 

CSingleCharPane: : ObeyCommand () is also inherited 
from LCommander and returns true if the command was 
obeyed. If we geL command 1000 (that's the command numlxT 
of die Beep item), well beep once and return true. Any 
other command causes a call to the inherited Obey Command (). 
This passes the command back up the chain to our commander. 
The LAppIdeation dass is the ultimate commander and has 
no supercommander, If the LAppIdeation class can't handle 
your command, you are out of luck! 

C5) ingleCharPane; : FindConunandStatus () is 
inherited from LCommander, It chec ks to sec if die command 
sent to it is 1000 (the Beep item). If so, it sets the enable 
parameter depending on whether mChar is set to ’x\ We could 
also have put a mark next to the Beep item or changed its 
name (try messing with these two; make the item name change 
to Beep followed by the current letter in the window, or add a 
checkmark next to the item when you type an V). If die 
command wasn't a 1000, we ll pass ii back up the chain. 

DrawSe 1 f {) is an LPane member function, DrawSe 1 f () 
is paired wilii a i numlxT function named Draw(). DrawO gels 
called to set up the pane's drawing environment in preparation 
for drawing (sort of like a call to SetPortO) and 
DrawSe 1 f () is called to do the actual drawing. You mighi call 
an inherited Drawf) method to prepare your derived pane for 
drawing, but you'll override the DrawSelf0 method to 
provide your own drawing method, 

CSingleCharFane () calls CalcLoca 1 FrameReet 0 to 
get our pane's Rect Well then set the font size Lo kFontSize, 
do some font calculations and draw the character in the window. 

By the way, if you are trying to figure out the calling 
sequence for an overriding function, check out the function you 
are overriding. For example, when you are creating 
CSing1eCharPane::ObeyCommand{), check out 
LCommander : : ObeyGotnmand () or, even better, 
CFPStarterApp;: Obey Command (). Also, get yourself a copy 
of Inside Pou'erPlant, which comes on your Code Warrior CD and 
contains complete descriptions of all of these routines. You can 
also buy a printed copy of Inside PowerPlant directly from 
Metrowerks. 

Adding the Include File CSingleCharPane.h 

Next, we’ll create the include file CSingleCharPane.h that 
defines the CSlngleChar Pane class, 

• Create a second source code file and save it as 
CSlngleCharPane.h. 

• Type in this source code: 

^Include <LPane,h> 

^include <LCoiiM/inder # h> 

class CSlngleCharFane : public LPane, 
public LComander l 
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Eddy Award Winner for Best New Developer Thai 

- MacUser Editors Choice Awards , 1993 

“A distinct improvement over ResEdit. * 

- MacTech ! MacTutor 

" Resorcerer’s data template system is amazing! n 
-Bill Goodman, author of Compact Pro 

'’Nuke ResEdit! Resorcerer is mission-critical for us.” 

Dave Winer , Userland Frontier 

“The color pixel editors are wonderful! A work of art!” 

- Dave Winzler, author of Microseeds Redox 

“Every Macintosh developer should own a copy of Resorcerer ” 

- Leonard Rosenthal, Aladdin Systems 

a Resorcerer will pay for itself many times over in saved time and effort 

- MacUser review 

“The template that disassembles 'PICTs is awesome!” 

Bill Steinberg, author of Pyrof and PBTools 

“Resorcerer proved indispensible in its own creation!” 

-Doug McKenna, author of Re sorcerer 

“...a wealth of time-saving tools, ” 

MacUser Review, Dee* 1992 


Resorcerer 


Version 1.2.4 


The Resource Editor for the Macintosh Wizard 


ORDERING INFO 


Needs: >Mrc Plus, > Sys 4.2, 1MB 
Likes: £Mac Plus, > Sys 7.0, 2MB 
32-bit clean, AU/X compatible 

Price: $256 (decimal) 
(Educational, quantity, or 
other discounts available) 

Includes: 500 page manual 
60-day Money-Back Guarantee 
Domestic UPS ground shipping 

Payment: Check, POs, or Visa/MC 

Extras (call us): 

COD, FedEx, UPS Blue/Red, 

I ntem alio nal Shi ppi n g 


Downloadable Demos/Updaters: 

AppleLink: Soft ware Sampler 
AOL: Software Libs/Development 
Com p u Se rve; MACD E WTool s 
or call uSh 


• New ‘cion’, ‘ppat’, *crsr% 4 acur', *pitP, ‘clut’ editors 

• Powerful icon family editing (all 9 icon types) 

■ Color pixel anti-aliasing, dithering, and lots more 

■ Complete ‘PICT disassembly and reassembly 
New 1.2 Features: • Resource sorting; ROM resource browsing 

• 120 template field parsing types now supported 

■ New insertion & deletion template field types 

• Text-only ‘PICT resources 

• Cots of improvements throughout 

• Easier, faster, more Mac-like, and more productive than ResEdit 

• Safer memory-based, not disk-filc-bascd, design and operation 

• All file information and common commands in one easy-to-use window 

• Compares resource files, and even edits your data forks as well 

• Visible, accumulating, editable scrap 

• Searches and opens/marks/selects resources by text content 

• Makes global resource ID or type changes easily and safely 

• Builds resource files from simple Rez-like scripts 

• Most editors DeRez directly to the clipboard 

• All graphic editors support screen-copying or partial screen-copying 

• Hot-linking Value Converter for editing 32 bits in a dozen formats 
•Its own 32-bit List Mgr can open and edit very large data structures 

• Templates can pre- and post-process any arbitrary data structure 

• Includes nearly 200 templates for common system resources 

• TMPLs for Installer, MacApp, QT, Help, AppleEvent, OCE, GX, etc. 

• Full integrated support for editing color dialogs and menus 

• Try out balloons, ‘ictb's, lists and popups, even create C source code 

• Integrated single-window Hex/Code Editor, with patching, searching 

• Editors for cursors, versions, pictures, bundles, and lots more 

• Well-designed, helpful developer tools being added all the time 

• Relied on by thousands of Macintosh developers around the world 


MATHEM^ESTHETIOS, INC. 

P.O, Box 298 • Boulder * CO * 80306-0298 • USA 
Phone: (303) 440-0707 • Fax: (303) 440-0504 
AppleLink/AmericaOnline: RESORCERER • Internet: resorcercr@aol.com 


















Get Net Wise... NOW! 


J ointSolutions Marketing is now creating 
exciting World Wide Web pages for various 
clients, including Apple Computer, Inc. 

We can also assist you with all aspects of data¬ 
base publishing and interface design. 

Call for the Web addresses of our latest projects. 

Don’t miss this opportunity to reach your 
target audience. Call today! 


Web Page Design 
i tml Conversion 
Button and Screen Design 

• Interface Design 

• Database Publishing 

• Project Management 


lolntSolutions Marketing 

408/338-6471 
408/338-6475 (fax) 
jsolver@aof.com (e-mail) 


JOIN 1 § 


public; 

emua 1 class_ID *= ’Cttidr* |; 

static CSingleCtiarPane *CreateSingleCharPancStreain( 

LStrcam * inStreaiii ): 

CSingleCharPanet LEiream MnStrean ); 
virtual Boolean HandleXeyPress£ 
const EventRecord frirsKeyEveiti ) ; 
virtual Boolean ObeyConunantK 

CommandT ittComraaTid * void *ioParam ): 
virtual void FindCoramandStatus( 

ComnundT InCommand* 

Boolean fcoutEuabled, 

Boolean fcoutUsesMark, 

Chari6 &outHark, 

Str255 outName ); 

virtual void DravSelf(): 

protected; 

char mChari 

u 

* Save your typing and dense the window. 

The CSingieCharPane class is derived from both LPane 
and LCommartder. Hie class definition starts off by creating die 
enumeration constant classJD which has a value of 1 Cmdr \ the 
same value you typed into the LParur's Class ID field in 
Constructor Next comes all of the member function declarations 
and, finally, the declaration of the data member mChar. 

Editing BeepCommandeilcp 

Your final bit of work is to add a few lines of code to 
BeepCommander,Cp, 


• Open the file BeepComtnander * cp. 

• Add these lines to Obey Comma rid (), just after the call of 
LWindow: : Great eWindow () and just lie fore die call to 
theWindow->ShowC): 

CSingleCharFane 'theCharFam? = 

(CSingleChatPane *)theWindow->FindPaAoflyTD( 2000 }; 
lheWlndow->SetLataiitSub( theCharP&Eie ): 

• Add ihis line to top of the file at the end of the ^include list: 
^include "CSlngUCbarParie.h w 

• Go to the Lop of the file and change the const 
window_Sample to have a value of 1000, like this: 

const RcsTDT window Sample - 1000; If EXAMPLE 

» Finally, add this code to the constructor: 

URegist rar::Regiiitei-CiasSt CSingleCharFaiu?: ;cliisK_tD* 
CSinglcCharPant♦:CreateSingleCharPaneStream ); 

Till Next Month 

Well, that's about it for tkepCommander. Once all your code is 
in, am the darn tiling. The window shown in Figure 1 will 
appear. Type some characters and watch the letters flash by. 
Notice that the Special menu is enabled only when you type 
the letter l x T , Why is the entire menu disabled and not just the 
Beep item? This is a feature, not a bug. PowerPlant disables a 
menu title when all of its items are disabled. 

Next month, we'll expand our horizons a bit more and 
explore yet another comer of PowerPoint. See you then... 1% 
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Fast remote internetworking 
in a single box. 


► Shared Access to the Internet 




Expt&asRouter pp$ 


► E-mail 

Streamline communications 
with enterprise-wide E-mail, 


Your whole department or organization can connect to 
the Internet—full time or just when you need to. 


► Telecommuting 

High speed access to 
the entire office network. 


ExprcssRoutcr 
w/ Frame Relay 
Interface 


Ex press Router-1 SON 


► Videoconferencing 

Close the gap between 
distant sites with LAN-to-LAN 
videoconferencing. 


► Centralized Databases 

Access or update Information 
from any point on your Wide Area 
Network. 


► Fast File Transfer 

Transfer files at speeds up to 
lJ344Mbps—10 MB per minute. 


Ex pr ess R miters 
with Integrated 
Interfaces 


What makes the ExpressRouter the best choice for your Wide Area Network {WAN) needs? 

• Built-in WAN interfaces for Frame Relay , ISDN, Tl. and 56Kbps DOS. 

• Expandable architecture that supports up to 3 high speed WAN ports. 

• Built-in support for AppleTalk. TCP/IP and Novell IPX LAN protocols. 

• Interoperability via PPP. 

• Support for SNMP and Telnet management standards. 

• Powerful, easy-to-use auto-dialer software designed for the Macintosh. 


Engage Communication , Inc. 

9053 Soquel Drive • Aptos, CA • 95003 

Tel: 408.688.1021 • Fax: 408.688.1421 • E-mail: sales@engage.com # WWW: www.engage.com 










CRABB'S 

APPLE 


By Don Crabb 



Putting the Moves on the Internet 


Well, we've all wondered, of course. 
Wondered when Microsoft would get 
serious about the Internet. Serious 
about leading its development. Serious 
about co-opting it as another market in 
Lite Microsoft hegemony. Serious about 
making the Internet and die World Wide 
Well the The Next Big Thing. 

Well, on December 7, 1995 (is ii just 
me, or does that date send shivers up 
your spine, too?), Microsoft stopped our 
wondering and let us have ii - right 
between the Web pages, if you will. 

To wit, Microsoft has decided to 
stop fooling around with its Internet 
science project (Microsoft Network) and 
to start making 11 every effort" towards 
“dominating” the World Wide Web, 
according to Microsoft co-founder and 
chairman, William Gates TIT. As such, 
Microsoft plans to integrate Internet 
components that ii is developing, as 
well as those it will license from others, 
along with communications links, into 
every Microsoft product, including 
Windows 95 and NT, Microsoft Office, 
Visual Basic, Access, and all of its 
development Lcxds, including SQL Server 
anti oiher big ticket items. I suppose it 
will even get into an upcoming release 
of Microsoft Bob! 


Tin- Microsoft Effect 

Whether Microsoft can come in and repeat its 800-pound-gorilla 
act among Internet and Web vendors remains unclear, however, 
rhanks, in no small part, to the current Web hegemony of 
NetScape Communications Corp. and the heavy Web 
bandwagon that Apple has successfully pulled down the road 
for most of 1995. 

But just the mere mention of that 800-pounder stomping 
around the Web caused NetScape's stock to drop 18 percent in 
a single day of Lrading - down $28.75 to $132.50 on December 
7. Another Microsoft Net competitor, Netcom On-Line, lost 
$875 to dose at $54.75 thaL day. Ouch, that hurt! 

Showing the ripples that the big hairy beast makes no 
matter where it treads these days, shares of Microsoft partner 
Spyglass also fell that same day, dropping $1475 to $95-25 - 
despite the fact that Microsoft's new Internet presence will 
make it heavily dependent on technology that Spyglass Is 
developing for its Internet Explorer browser. 

Meanwhile Microsoft's own stock slid a piddling 12.5 cents 
to close at $90.50. 

Besides partnering more heavily with Spyglass (watch your 
backs, guys), Microsoft has embraced Sun Microsystem's Java 
and JavaScript, a mere week after every other computer 
company on the planet already declared JavaScript the new 
lingua franca of the multimedia Web. Apparently, even 
Microsoft is mortal. 

Although we can certainly expect them to figure some way 
to co-opt Java to their own market aspirations - no matter how 
"open" Sun insists it will remain (just ask Cl Uibs how much 
Microsoft has embraced OpenDoc if you doubt their comfort 
factor at dealing with standards they don’t own and control) - 
with Java already being supported by all the other computer 
bigshots (including Apple), Java’s probably tcx> big for even 


Don Crabb - Don is a contributing editor anti columnist for MacTech, MacWEEK Mac USER, Metc/Cbicugv, Digital Chicago , 
MacToday, Win95U$er t GmputerUser, Ihe Chicago Sun-Times Features Syndicate, The Springfield Union-Neu^ PC Magazine, 
and about a million other publications. Don welcomes comments ai his Internet address: don_aabb@mactech.com. You can 
also check out his WWW Home page at http://www.ciudiicago.edu/-decc/. 
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Gives you the Information to Program your Best ! 


The Debugger V2 
& MacNosy 

By Steve Jasifc 





Information 




Control 


T he Debugger is a low and high-level symbolic 
Debugger that runs in a full multi-window 
Macintosh environment. You can Lrace program exe¬ 
cution, view the values of variables, etc. of both G8K and 
PowerPC programs. 

MacIVosy is a global interactive disassembler that 
enables one to recover the source code of any Mac applica¬ 
tion. resource file or the ROM. 

When you compare features of the different debuggers, 
note that only one has all the below features to help you get 
your job done, and only one has MacNosy to help you debug 
any program in a full system (6.Ox or System 7,x) environ¬ 
ment symbolically! 

It is the only debugger to use the MMU to protect your 
CODE resources and the rest of the system from the pro¬ 
gram you are debugging. With MMU Protection you can find 
errors when they happen, not millions of instructions later! 
(Macintoshs with 68030 CPUs only). 

The Debugger is the debugger of choice at: Adobe, 
Aldus, Claris, Electronic Arts, Kodak, Metrowerks, etc. 
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Art example of a structured data display window 


Its Features Include: 

• Symbolic Debugging of any Macintosh program, ROM, or 
cock resource [DRVRs, XCMDs, lNITs, PD&Fs, 4DEXs ..) 

• Source level debugging for Metrowerks & MFW compiled 
programs (C++, C t Pascal. Fortran,..,), and an Incremental 
Build System with instant Link for super fast development. 

• Object Inspector for MacApp 3 programs 

• Source level debugging of Think C™ projects 

• Includes a program (CoverTest) to interactively do Code 
Coverage analysis for SQA testing, etc, 

• Simultaneous Symbolic debugging of multiple “tasks” 

• Fast Software Watchpoint command to find clobbered 
variables 

• Sophisticated error check algorithms such as Trap 
Discipline (Argument Checking}, Handle Zapping. Heap 
Scramble and Heap Check to detect program errors before 
they become disasters 

• Structured display of data (hypertext) with user definable 
structures while debugging 

• Conditional breakpoints to help filter out redundant 
information 

• Continuous Animated Step Mode to watch your program 
execute instruction by instruction 

• Detailed symbolic disassembly for both 680x0 and 
PowerPC with symbol names, labels, cross ref maps, 
make it possible to ferret out the secrets of the ROM, etc, 

• "Training Wheels" for the PowerPC disassembler to help 
you learn the opcodes 

The Debugger V2 & MacIVosy: $350 

Runs on all Macs. Call For Group prices or Updates, 
Visa/MC Accepted. 

Available from: Jasik, APDA, Frameworks or 
ComputerWarc (800-326-0092). 


Jasik Designs 


343 Trenton Way, Menlo Park, California 94025 * ( 415 ) 322-1386 
Internet: raacnosy@jasik.com • AppleLink: DI037 






















Only PowerTap™ v3*0 software enables your host 
application to tap every processor in the Macintosh and 
on the net at once , It is as simple as a black box, 
compatible with everything and geLs your job done as 
fast as possible—the same way regardless of the runtime 
environment It just doesn't get any better than this! 


1 Royalty-free 
1 Robust 


1 Compatible 
1 Easy to use 




Emerson Kennedy 



(800) 297-3888 

powe rtap <$aof co m 
ARA: 804*261.0973 


PO Box 2530 * Redmond. WA 98073 


Unde Bill to kill. No matter how much he'd like to, since it 
poses a big threat to the growth of Visual Basic as the choice 
for Web creation, 

in the same set of announcements, Microsoft’s Gates said 
that "the Internet is the primary driver of all new work we are 
doing throughout the product line/ Gates also said, “We are 
hard-core about the Internet,” As if any of us needed to lie 
reminded. J can’t imagine any Mac developer actually 
believing Microsoft would attempt anything less with the Net 
than ifs done on the desktop near-total hegemony. 

So, there we have it. Microsoft is going to iry to kill 
NetScape and as many other Net rivals as it can (IBM’s Lotus 
Notes division, America Online, and Unix companies including 
Sun Microsystems - no matter what they say about java). And 
those it cannot kill, it will try to absorb* like Spyglass* 

What does this all mean for Mac developers? 

The Mac and Thu Web and Mr. Bill 

Well, make no mistake about it, Microsoft is psyched to chomp 
up the Net, According to Roger B* McNamee of venture capital 
firm InLegral Capital Partners of Palo Alto, CA, dr was really fun 
to see Bill Gates so pumped up. He had the same kind of fire 
in his eyes that I suspect he had 20 years ago when he started 
the company. 


“I imagine he has been wrestling with the approaching 
mamrity of his core business* and wondering what to do with 
it," McNamee continued, “The Internet offers Lhe right scale of 
business opportunity at just the right time." 

But just because Bill and Microsoft are jazzed about 
devouring the Internet, does that mean they will pull it off? 
Not by a long shot. The differences between having a good 
plan and executing it flawlessly have slain bigger dragons than 
Microsoft* And with the Internet, where part of every 
successful software vendor’s strategy to date has been free 
software, Microsoft has little practice. 

Still, Microsoft has promised to give away its Internet 
Explorer and Web server software for mast platforms - Unix, 
Windows 95, Windows NT, and even the Mac OS - in an effort 
lo blow away NetScape and gain the lion's share of the market. 

No matter how successful or unsuccessful Microsoft is at iLs 
Web hegemony strategy, Microsoft's move into the mainstream 
of the Net and the Web Is good news for Mac developers. But 
only as long as Apple can continue to try to push the Mac: OS 
into all the expanding comers of these markets (by getting us 
Cyberdog and OpenDoc and by partnering with NetScape to 
provide us with a browser construction kit that can easily be 
incorporated into our own applications), ff Apple can maintain 
its thrust, having Microsoft help out by pushing its own 
browser onto the Mac 0,5 is a win for us. 

The key here* though, is noi what Microsoft does, but 
what Apple does (and what we do with it), as well as its major 
development partners. With Metrowerks cranking out a 
Codewarrior for JavaScript, we ll have one of the core tools we 
need to accelerate Web product development beyong the 
HTML and CGI *stale, but we need others that do not require C 
and C++ expertise. 

For Apple to help us carve out the Web high ground, we 
need tools that lei AppIcScriptcrs (borrowing from CylxTdog in 
some ways?) build Web objects that work with the other tools 
they use each day, be they multimedia, or database* or 
spreadsheet, or decision support. In short* we have a real 
opportunity here, now that Microsoft has joined the Well party 
(and before they can choke it into proprietary conformity)* to 
spawn a new generation of object tools for Mac users and 
managers that can be used without programming experience to 
build sophisticated query and information delivery systems on 
top of their Web servers, while also being able to build ad hoc 
looks into other Web sites. Bui they need the solid Mac tools 
to do this; HTML and CGI and even JavaScript are at once too 
limited, too complicated, and too tweaky. 

Maybe Apple ought to reconsider Apple Dylan as the core 
for such a group of Web tools* Maybe SK8 could have a second 
coming as the engine behind such a tool package. Or maybe 
even a new version of HyperCard* strengthened with 
AppleScript, Cyberdog* and OpenDoc* anti with an easy way to 
add Java applets, could fill the bill, I just hope that the bill gets 
a close examination while we still have this golden opportunity. 

ft 
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Drazv and verify your design, generate code or reengineer existing code Bac^to diagrams 



OOA/OOD includes OMT, Booch 94, Coad/Yourdon, Shlaer/Metlor... 



Structured A&D using Yourdon/DeMarco, Gane/Sarson. Hatley/PirbkaL 



Data modeling and SQL generation for Information Engineering, Chen... 

MacAnalyst 

& 

MacDesigner 


Software Engineering 

Structured Analysis & Design 
Object-Oriented Analysis 8l Design 
Real-Time & Multi-Task Design 
. . Dam Screen Modeling 


si 


Integrated Code Editing Si Browsing 
Multi-User Dictionary & Requirements 
Code to Design for C++, Pascal Fortran.. 
Design to Code for C++, Pascal, Fortran... 




New in Version 5.0 

Jacobson, Fusion, Use 
Cases, Harel Statecharts, 
Interaction Diagrams and more 




Products are available by single, site or 
educational license and supplied with on-site 
training, update service, free newsletter and 
technical phone support. Products include 
sample documents, tutorials and online help. 




Product Options 


MacAnalyst 

MacAna lyst/Expert 

MacDesigner 

MacDcsigncr/Expcrt 

MacA&D 

Translator 


$ 995 
$1595 
$ 995 
$1595 
$2995 
$ 495 



System Requirements 

JVTacintosh System 7 with 8 meg RAM or 
UNIX with Apple's MAE software, 

J Winner of the 1 994 CIO Magazine 
Readers' Choice Award, MacAnalyst 
and MacDesigner are used by thousands of 
developers worldwide for personal computer, 
mainframe and embedded software projects. 

Call now for free technical brochures! 

Excel Software 

515-752-5359 

P.O. Box 1414 • Marshalltown, LA 50158 
easelools@aoLcom * Fax: 515-752-2435 

MacAnalyst. MacDesigner, MacA&D and Translator 
are trademarks of Excel Software, All rights reserved. 






































































































































































FREE INSTALLER! 


To: 

From: 

Subject: 

Message: 


Mac Developers & Product Managers 

MindVision (Co-authors of Speed Doubler) 

Free Copy of DEVELOPER VISE 

We've got a great new installer for you. 
Here's your chance to try it for free. 

No risk, no obligation, no hassle. 

Call today, don't delay! 
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www.mindvision.com 


NTERNET: SALES@MINDVISION.COM • APPLELINK, AOL: MINDVISION • COMPUSERVE 70253,1437 



Join Lhe growing list of companies who use our VISE technology: Adobe, America Online, Apple, Claris, 
CompuServe, Conneaix, Intuit, MacroMedia, Netscape, Symantec, WordPerfect, and hundreds others. 


MindVision Software 840 South 30th St, Suite C, Lincoln, Nebraska 68310 
Voice: (402) 477*3269 Fax: (402) 477-1395 Internet: sales@mindvision.com 
AppleLink, AOL: MindVision • CompuServe: 70253,1437 

© 1992-% MlnciVbviofl Software. All Rights Reserved I>?«dnpcrVl5E is a trademark tif MlrnlVlsion Software 





































































SYMANTEC 
TOP lO 


By Michael Hopkins, Symantec 


SYMANTEC.! 


This monthly column, 
written by Symantec’s 
Technical Support 
Engineers, is intended 
to give our readers 
technical information on 
using Symantec products. 


Q: I am compiling my project with the 
THINK Project Manager and I get an 
error message "Error: Illegal 
Near Data 11 . What can I do to 
correct this problem? 

A: This typically occurs when you have 
Far DflTR checked in the Project 
Options dialog box and not Far 
CODE. To turn on Far CODE, 
choose Set Project Type from 
the Project menu and check the 
Far CODE check box. For more 
information on how to use Far 
CODE and Ear DATA, consult your 
User’s Guide. 

Q: 1 have written some simple code that 
has a structure declaration in a header 
file and then a global variable of that 
structure type in my main source file. 
When l compile the code, I get the 
message "Error : Size of struct 
is not known". Furthermore, when 
f preprocess the file, 1 don’t see my 
struct declaration being included. 
What is going on? 

A: Lets Lake a look aL an example: 


^Include "L inter Jj" 

struct clock local_clock: 

mairri) 

t 

I 


r mauu; 7 


struct clock \ 
long start_tims; 
long end_time: 


r timer.h 7 


What is wrong with this picture? Well, there is actually 
nothing wrong with the structure. The problem is that 
Timer.h is the name of a system include file that is 
automatically included as part of the precompiled headers (in 
this case, Mac Headers). Therefore, the user header file is 
not being included because a system file of the same name is 
being used. To correct this problem, cither rename lire user 
header file or, for non-Macintosh applications, do not include 
MacHeaders in the prefix. 

Q: t am writing a virus scanning program and I need to 
examine code resources of an application to verify that they 
are valid. What information does the Symantec Linker place 
in the first two bytes of the code resource? 

A: For all CODE segments besides CODE 0, there is a code 
segment header. The THINK linkers use the upper bit of this 
header to indicate a model Far CODE segment. The runtime 
loader resides in CODE 1 of the application and is the first 
piece of code executed. The loader loads and initializes the 
DATA and STRS, installs hooks for _LuadSeg, _UnloadSeg, 
and _Ex.it To Shell traps, and calls the main program. 

If the code is using a far model, the Loads eg and 
_UnloadSeg bottlenecks completely replace the standard 
segment loader. The standard 4-byte CODE segment header 
is interpreted differently to accommodate the larger jump 
Lable, so it is incompatible with the ROM segment loader 
The header has the following format: 


15 14 0 


R 

index of 1 3t jump table entry 

F 

number of jump table entries 
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hen it comes to text editing haw you 
hoped for a little divine inter- 

Whether you're developing lire next "killer" inter¬ 
net application, building a custom publishing tool or 
adding advanced word processing to your (id) pro¬ 
gram, you can’t ignore die quality of your text editor, 

Witli PAiGK you can create the most sophis¬ 
ticated text features in die business, including: 

• Stylized Text 

• Text Wrapping 

• Embedded Objects 

• Shapes & Containers 

• Virtual Memory / 

• Style Sheet Support 

• Multi-lingual Capable 

• Portable C Code 

• Royalty Free 

PAIGE is written in portable C and uses no global 
variables. Machine specific code is minimized to 


ensure a consistent API r> 

for all platforms— /** 
simplifying multi- 
platform development, 

This strategy allows 


you to move your 
application to oilier 
platforms while main¬ 
taining data and application compatibility. 

To simplify the integration of PAIGE into Windows 
(Id-bit, 32-bit, '95 or NT) applications, our library 
ships as Dll's and can be used as a custom control. 
Combined with the message based demo source code 


and simple introduction guide, PAIGE gets programmers 
up and running quickly. 

So why should you buy PAIGE? TIME. Programmes 
can’t afford to reinvent die wheel when implementing 
advanced text features within their applications. 

Join die hundreds of major software publishers 
using PAIGE as their total text solution. For a complete 
technical and pricing summary, or to request our prod¬ 
uct demo, contact die DSI sales department today at 

800-327-6703 or 360-573-9155. 



DataPak Software Inc. 

9317 NE Hwy 99, #G • Vancouver, WA 98669-8990 
Bus: (360) 573-9153 • Fax: (360) 573-9269 

Internet: 76424.3027 Gkompuserve.com 
www.teleport.eom/~datapak/datapak.litinl 
AppleLink: D0I42 • AOL: DAT'APAKl 

• CS: 76424,5027 


“Say, nice job brother John. Now could you make it a three column 
format with digital memos embedded in the text stream?” 


The R liit indicates that the segment has .relocations which 
must be applied ar runtime. These are stored in a OREL 
resource with the same resource ID as the CODE segment* 
The bit is used to distinguish a far header from the 
standard header. 

tie aware that this format is different from the header that 
MPW and Merowerks use as well as the OFM-68K header 
format. 

Q: \ am trying to use ODBC (Open DataBase Collaboration) with 
the THINK Project manager and I am getting a number of link 
errors. What library files to I need to add to use ODBC? 

A: To use ODBC, you will need to include: 

• MacTraps and MacTrapsZ 

■ LibraryManagerCiient*o 

• a ] loc_private * c 

You will also need to write two additional functions (source 
is in THINK Reference under Embedded DefProc); 

Boolean TrepAvaiTable( shorn theTrap ); 
void FlushCachet void ): 


If you are compiling one of the demos* you will need to 
write a striemp: 

pascal short stricrap{ const char *s* const char * s2) 
i 

return (shorn)strcnrpCs* s2); 

1 

Q: I am making a 68K version of my PPG application and Pm 
getting a link error with numtostriag() which is in 
Text Util s * b. On the PPG, this routine is in 
IrtterfaceLib* xcoff. Where is it <>n t!ic 68K mac? 

A: It is important to realize that the lower-case version of 
numtostri ng() is different than WutnToString() which 
is in MacTraps. NumToString() returns a pascal-style 
Str255* and numtostring () returns a c-style string. To 
use the lower-case version with the THINK project manager, 
you will need to include Apple C Glue which is in 
Macintosh Libraries *68K Libraries from the 
Symantec C++ vH Release 4 CD. 

Q: Is there any way that I to make the Finder run Power 
Macintosh DebugServices when I launch the SPM? 
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You Can't Wait Forever. 


Let's Face It 

As a professional developer or webmaster, 
you have to think of yourself first. You have 
deadlines to meet, products to deliver, and 
people depending on you. 

A Tool in Hand... 

Your tools are your livelihood. You need up- 
to-date technologies and timely support. You 
can't afford to wait for vaporware to material¬ 
ize or lor your tools vendor to leisurely add 
features that you need today. 

When Hell Freezes Over? 

When was your text editor last updated? Six 
months? A year? Five years? And when you 
contact the vendor that produced it, do they 
tell you how they're working on the next great 
version, how wonderful it's going to be, and 
how it will ship "Real Soon Now"? Or worse 
yet, do you get a disconnected phone number? 

That's where we come in. 

At Bare Bones Software, we deliver the best 
tools here and now. We have a distinguished 
tradition of continually enhancing the function¬ 
ality, performance, and design of our products 
to meet our customers' needs. We don't allow 
our products to languish until we feel like doing 
something about it. We won't hype vaporware 
as the solution to today's problems. And we 
haven't drifted in and out business on a whim. 
We're here to support you for the long haul. 


What About the Software? 

You don't have to wait for the software, either. 
We're constantly refining our techniques and 
technology to bring you the fastest and most 
efficient tools. As the result of our efforts, 

BBEdit has repeatedly raised the standard for 
Macintosh text editing. (In fact, we've done so 
many cool things, several of our competitors 
have tried to copy us. Imitation Ls the sincerest 
form of flattery, after all. We're very flattered.) 

Why Believe Us? 

Since its commercial debut in 1993, BBEdit has 
set the pace for capability, user-interface, 
functionality, and customer support that others 
have yet to match. BBEdit was the first text 
editor to support TooIServer, THINK Reference, 
Toolbox Assistant, THINK C/Symantec C++, 
Internet Con fig, Quickdraw GX printing, 
PowerTalk, PowerPC acceleration, AppleScript, 
Apple Guide, and Macintosh Drag and Drop. 
We're still setting the pace for others to follow, 
as the only Macintosh text editor to integrate 
directly with Metrowerks CodeWarrior, through 
the use of the Click Warrior extension. 

See for Yourself. 

We've painted a great picture, but don't take 
our word for it Visit our Web site and see for 
yourself. You'll find lots of things to like. 

BBEdit. Because you 
can't wait forever. 


B Bare Bones Software, Inc. 

P.O. Box 1048 

Bedford, MA 01730-1048 USA 

Voice: (508)651-3561 
Fax: (508) 651-7584 

E-mail: bbsw@netcom.com 

BDfflflutl Web: http://www.tiac.net/biz/bbsw/ 

Oiir lawyers Insist we say: HUhcht ami mi w spiffy logo are trademarks erf Bane Bones Software, Inc. Mac and the MacOS logo are htwrlrnwrks of Apple 
Computer, Inc., used under license. PowerPC trademark of lnUrm.ihoo.il tfuslnts* Machittc* Corpora lion. All other trademarks and restart'd trademarks 

.ire properties of their respective holders. Bare Bones Software, Inc. products are cruelly free (except for a lew beLt testers). l W6 Bare Bones Software. Inc. 



















Mac Source Code CD-ROM 

Apprentice 4 
is here! 

"ft's wonderful. It’s saved me probably 20 hours of time 
in Just the fast week * ft is weft worth adding to your 
collection, definitely one of the most useful CDs in my 
collection. * 

- Peter Lewis 

Over (iSl) rn^hyft?s of hijjvqualily and uplcKiaic Mac-orcly source code from 
hundreds of programmers. If you're looking for great source code examples, this is (he 
CD-ROM for you. All or the source code exam pies are new and updated in this release! 
Apprentice source is mostly C, C+t, and Pascal, using CodeWarrioe Symantec, and 
MPW. Includes examples of applications, games, rode resources, control panels, 
system extensions, plug-in modules, hundreds of snippets, and much more! 

$35. Upgrade from any previous Apprentice release for only $251 

Shipping included (or U& and Canadian orders. Add J5 for,shipping outside Ihe U.5; arid Canada 

Visa, MasterCard, American Express, and Discover gladly accepted 


Celesiifi Company, Inc*, 1152 Hastings Avenue, Port Townsend, WA 98368 
800 835 55T4 • 360 385 3767 • 360 385 3586 fax 
Internet: cdeslin@celestio.com * http://wmv.ee! estin.com/ 


A: No, but you could tell SPM to launch PebugServices on 
startup or shutdown. To run a script automatically when the 
Project Manager opens, record or write a script using the 
Script Editor Save the script in the (Scripts) folder and 
name ir “Startup". Alternatively, if you want the script to run 
on exit from the Project manager, name it "Shutdown”. 

Q: I’ve noticed that all native applications have a note in the 
“Get Info* window that says: “Memory requirements will 
decrease by xxxxK if virtual memory is turned on in the 
Memory control panel". Won t using virtual memory 
decrease my application performance? 

A: No, not necessarily. In some cases the use of virtual 
memory on Power Macintoshes can actually increase the 
runtime performance of your application. When VM is not 
enabled on a Power PC. the application's stack, heap, and all 
of its code fragments have to be loaded into the application's 
partition. With VM on, only the stack and heap are loaded 
into the application's partition. This reduces launch time 
and requirements for native programs. The Virtual Memory 
Manager will track your applications code fragments and 
load them into the application's partition only when they arc- 
needed. If done correctly, this won't result in a noticeable 
performance penalty and die application will launch much 


more quickly. For more information, refer to Inside 
Macintosh: PowerPC System Software. 


Q: How do 1 create a Cus lomTEHook on a PowerPC? 


A: It is actually fairly straight-forward thanks to Apple's 
Universal Headers. Create your hook procedure with the 
following signature: 

pascal unsigned short myTexlWldthHookPror{ 
unsigned short textLen. 
unsigned short textOffset* 
void * textBufferPtr, 

TEPtr pTE, 

TEtfandle hTE 


Then create a routine descriptor and call TECustomHook 
like this: 

ToxtWldthHookllPP ray UP P - 

NewTcKtWidthHookProt( myTexTtfidthHookProc ): 
TKCustomilook( intTextWldthHook, fernyUPP* myTE ); 


Q: i have noticed that there is a problem in CDialogText where 
cuts, copies and pastes are not reported to the supervisor of 
Lhe CDialogText. Is there an easy way to fix tills? 


A: Yes t there is. Change the code for CDialogText: : 
Do Command ID; 


void CDialogText: rftoComtimnd { long theCoraraand ) 

I 

inherited;:DuCuunandt theConmutid ); 

switch( theCotmnand ) 

I 

case rndCut; 
case rndPaste: 
case rwdClear: 

If (editable] 

BroadcastChangef dialogTextChanged. 6TD ): 
break: 
default: 
break: 



Q: How do 1 force Visual Architect to re-gene rate all sources 
including the files rhat should only be generated once such 
as CMain and CApp? 

A: Take the Source directory in your project folder and either 
rename it or move it to a different location* Remove all of 
your existing generated VA files from your project. When 
you choose Generate Hll from the Visual Architect, it will 
create a new source folder and generate all of the files and 
then add them to your project. 

Special Thanks To 

Levi Brown, Craig Conner, Rick Hartmann, Noah Lieberman, 
Andy McFarland, Scott Morrison, Phil Shapiro, Jeff Weeks* 
Kevin Quah 
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OBJECT 

PASCAL 


By Brian Arnold 



MacApp 2 for PowerPC in Object Pascal 


“Object Pascal is not bad\ 
it just smells funny. ” — 
apologies to F.2L 


Whither Native? 

This is an article for developers who 
have Object Pascal MacApp 2 axle and 
want to make that code native for 
PowerPC for for anyone whose pulse was 
sei racing by Brian's and Guy 
MacCarthy's preliminary report in the 
November 1995 issue - man!. Along the 
way T it will describe the MaeApp2PPC 
developer's cooperative as an example of 
how developers can help themselves 
when they need it the most. Although 
the MacApp framework iLself has long 
since made the switch to the PowerPC, it 
has done so at the expense of Pascal 
Object support. The latest version of 
MacApp, 3-3, is written in C++, and has 
features to make you salivate - drag and 
drop, AppleScript, PowerTalk mailers, 
performance optimizations - and version 
3.5 will have OpenDoc container 
support. You could convert your source 
code and upgrade today; many 
developers liavc done this, 'Inhere are a 
number of excellent Object Pascal to C++ 
translators available on the market to 


help you in this conversion. But if you're resource constrained, 
or C++ syntax causes a gag reflex, or you have some other Very 
Important Reason to stay with your Object Pascal MacApp 2 
code, MacApp2PPC provides another alternative. 

MacApp 2 ion PowerPC 

The Pascal version of the MacApp framework is hardly five years 
old now, and it 5 s already doomed to obsolescence. Or is it? 
Maybe once OpenDoc and SOM arrive in full force, we can seal 
the coffin on this version of the framework and look elsewhere 
for Object Pascal framework solutions. But until then, die lean 
and mean MacApp 2 still has some mileage left in die millions of 
lines of excellent Macintosh code written using it. 

So what’s so difficult about porting MacApp 2 to PowerPC? 
To find out, t announced a developer's cooperative at the Apple 
May 1994 WWDC Immediately, twenty developers joined* We 
encountered several difficult obstacles, and by distributing the 
effort among the developers, we were able to make the 
necessary changes to MacApp 2 in just under 12 months. 

Of course this would all be academic if there hadn't liecn 
support from Apple and the compiler vendors. Language 
Systems (LS) licensed MPW Pascal from Apple and further 
developed a PowerPC back-end; LS is now developing it as a 
Symantec IDE plug-in compiler. They were instrumental in 
providing us with support when we went; just getting started 
Apple aided in the development of die project, particularly at 
the hack session that helped finalize the port, Metro works 
developed a compatible PowerPC Pascal compiler, and later 
added Pascal Object support and made it a plug-in compiler for 
die Code Warrior (CW) IDE. 

MacApp 2 for PowerPC has lieen designed to work with 
txxh die LS Pascal and CW Pascal compilers, and is provided by 
both Language Systems and Metrowerks for use with their 
native Object Pascal compilers. 


Brian Arnold ltrian Arnold is the director of software development at turnout Decision Systems, Inc . He's die chief 
architect of Analytical, a visual decision analysis modeling tool, and he spends his spare lime fiddling with OpenDoc* You 
can visit his web site at http://www.lum ina.co^ or you can reach him at amo!d@luminaxom, 
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MacApp 2 Conversion 

Here’s the short list of elements in MacApp 2 that had to 
be changed for PowerPC, 

* MacApp 2 makes extensive use of 68K assembly and in-line 
code that can’t run (easily) on PowerPC. Tills code had to 
be rewritten in Pascal t C t or PowerPC assembly, 

* MacApp 2 relies on AppFile Toolbox calls and has no 
support for required Apple events. The PowerPC runtime 
architecture does not support AppPile calls for opening 
documents at application startup, and expects you to 
support the required Apple events (open application, open 
d<x:umenI, prim doettment, quit application). 

* MacApp 2 uses 68K-specifie methods for trap patching. On 
PowerPC, patching a Macintosh Toolbox trap is a lot less 
trivial and more costly, so it needs to be done differently 
and less often. 

* MacApp 2 makes extensive use of ProcPtrs for Mac Toolbox 
callbacks. Since the PowerPC Toolbox is designed to 
operate with both PowerPC and 68 K applications, all 
callback ProcPtrs need to identify whether they are 
compiled for 68K or PowerPC. A toolbox glue routine for 
each ProcPtr fills in this information, plus some other 
housework, and returns a Universal ProcPtr that you use 
instead of the ProcPtr, 

* MacApp 2 uses old and obsolete Tcx)ltx>x names extensively. 
The PowerPC runtime architecture uses shared libraries (code 
fragments) that implement newer, more consistent names for 
Toolbox calls. Because Toolbox calls are resolved by name, 
the new Toolbox names must lx.* used. In addition, the Pascal 
QuickDraw global* thePort, gray, etc, now r reference Lhe 
qd global (e.g., qd . theport), as it is in C. 

* Developers have relied on unsupported extensions that also 
needed to lx: ported. These extensions include Model Far, 
floating windows, tear-off menus, anti synchronized .scrolling. 

* Finally, adding sup|>oit for PowerPC Object Pascal compilers 
and IDEs was a prerequisite. The build process needed to be 
revamped to support the latest development environments 
and tools, and the documentation had to be revised 

This .sounds a bit daunting. Frankly, when 1 announced the 
MacApp2PPG developer’s axrperative, l didn't have the foggiest 
idea whether or how we were going to succeed. However, i 
did know a little bit about what needed to get done and I called 
upon members of the MacApp 2 developer community for their 
interest in helping themselves. I did not expect this inquiry to 
generate a lot of interest, but we developed into a 100-member 
Internet mailing list. I also did not expect to witness much 
enthusiasm, hut it was there in spades. 

Essential Ingredients for Making It Happen 

We were so successful with the MacApp 2 PowerPC port dial 
1 am compelled to muse on why this was so. Ii isn't so hard to 
identify the elements, because we promoted them from the start. 


• Nobody else is going to do this for you, so you had better 
do it yourself. 

■ Only do what is necessary , and do no more. 

• Don’t change anything that doesn’t need to lx changed, 

• Trust your instincts. 

When you take personal responsibility for managing a 
task, the details become much clearer to you, and you are more 
productive. Secondly, when you focus on only what is 
necessary, the right tiling to do comes out of the woodwork 
and other gunk tends to stay out of the way. Finally, when you 
don’t change things that would seriously affect the user of the 
framework, something mysterious and wonderful happens: 
their code gets ported faster. The extra ingredient, TmsL your 
Instincts," is the reason why I persisted with MacApp2PPC for 
the past year and a half. It didnh him that the Internet (and 
AppleLink) helped people across continents share ideas and 
code to make this happen. 

For the first eight months, Masahiro Abe, Per Bergland, and 
Dave Johnston laid the foundation for the port by switching 
MacApp to the new Toolbox names, rewriting assembly code in 
C, Pascal and PowerPC assembly, and developing conversion 
scripts for our own code, while the remainder of the 
cooperative provided feedback. 

In March 1995, when it looked like we had completed all 
the difficult porting tasks, we held a three-day hack session at 
Lumina, where a dozen developers and Language Systems and 
Apple engineers converged to identify the remaining porting 
issues. Lumlna’s Brendan Del Favero set up the ethernet, and 
John Corbett made the logo. LS s Steven Hopkins and Steve 
Lavagnino were in the compiler hot seat. Apple’s MPW 
entomologist Greg Branche helped out with MPW-related issues. 
Dave Johnston practically lived inside the PowerPC debugger all 
weekend. Cheryl Lins and 1 went wild on adding floating 
windows support to MacApp 2. Larry Tesler, Apple’s chief 
scientist and the one to blame for MacApp 1.0 t stayed up late 
hacking code with Colleen Barton, and contributed a change to 
his USynchScroOer unit, Andrew Peterson and Larry Hamel 
came to port their MacApp 1.0 application. Eric Jackson, Mr, 
Mae Wireframe, didn’t use MacApp 2, but provided a lot of 
feedback on PPC Pascal code generation. Masahiro Abe, Per 
Bergland. David Shill itto, and Ingo Ciechowski provided remote 
input and feedback. As you would expect for such an event. 
Prograph guru and MacApp afficionado Kurt Schrnucker visited 
and handed out C++ barf bags. I highly recommend throwing a 
hack session; nothing helps Inner to identify the critical tasks 
while having a lot of fun. 

A few weeks after the session, Metrowerks added their 
support with the help of CW Pascal architect Marcel Achim and 
developers Roger Brown, Peter Baum, Donald McCormick. 
Farhad Anklesaxia, and Scott Vorthinann, all of whom 
contributed one change or another. By the May 1995 Apple 
WWDC in San Jose, CA, we were able to claim that ' Nothing 


26 


MacApp 2 fok PowerPC in Object Pascal 


MacTechMac.azine • February 1996 








When it comes to performance dtF is in a 
class all ils own. dtF utilizes a proprietary 
query optimization and caching scheme to 
obtain unparalleled performance. If you are 
in need of a quantum leap in performance, 
use the dtF native PowerPC stand-alone or 
client/server version. 


Full transaction control and automatic level-3 error 
recovery guarantee maximum data protection even after 
sudden system crashes. dtF databases are compressed and 
encrypted to protect against all unauthorized access, even 
disk editors. Implement sophisticated table and operation 
level security with dtF's password features. 


J a.¥7i The Relational 
14. Vjl Database System 



Stand-alone 
applications built with 
dtF are royalty-free! 


...data security 


With dtF’s unique direct integration technology, the dtF database system 
is Fully contained in your application, enabling you to build double- 
clickable database applications. Never worry about missing or conflicting 
INTTs or drivers. dtF's native API is compact, easy-to-use and integrates 
seamlessly with all major development environments on the Macintosh 
dtF's high performance SQL, integrated data dictionary, security 
features, automatic index selection, query optimization and error 
recovery allow you to concentrate on creating great database applications 
instead of messing around with the internals of the database system. 


dtF is available for Macintosh System 7.x (68K and native PowerPC). 
dtF supports MPW C/C++, Symantec C/C++, Metro works Code Warrior 
(all compilers 68 K and native PPC). dtF is fully Open Doc™ compatible. 
Separate versions for use with HyperCard 2.x, SuperCard 2.x, Smalltalk- 
A gen is and Pic Lor ins Peregrine are provided. AppleScript interlace via 
DataScript™ for dtF from General Knowledge. dtF supports cross- 
platform development on Windows 3.1 L Windows 95 and OS/2. 


dtF Americas, Inc. 

19672 Stevens Creek Blvd., 
Suite 128 

Cupertino, CA 95014 
USA 


Phone: (800) DTP 1790 

Fax: (510)828-8755 

AppleLink: DTK AMERICA 
l ntemet: df Lam erica @ 

applelink.apple.com 


+I4-XT The Relational 

Ulr Database System 














works!”, “Failure fails!*, and “Windows float!" In case you're 
not familiar with MacApp, Nothing is (he name of the i-line 
“Hello World" example application, UFailure is the name of the 
seminal framework failure handling mechanism, and windows 
never used to float in MacApp 2 (that pari we borrowed from 
MacApp 3). These were our milestones. Most of us were 
amazed that we succeeded in one short year. 

Porting Your Source Code 

Along the way to developing MacApp2PPC, we tried to 
come up with tools and hints for making the leap to PowerPC 
with your own code. The rest ill is a set of MPW scripts that you 
can execute to do most of the conversion work for you. 
However, because MacApp2PPC was constructed to minimize 
the damage to your own code, you may be surprised at how 
little time it would take you to port even without the MPW 
scripts. 

Running the scripts is easy, provided you can already 
tolerate MPW 

1. Install MacApp2PPC and a minimal MPW according to the 
instructions provided on your compiler vendor's CD. It is best 
to use a fresh MPW setup, not one that you’re already using. 

2, Stan up MPW. Confirm that MacApp2PPC installed correctly 
(its menu is added to the menu bar)* 

3- Set the current directory to one containing your Pascal 
source code, and select Conuert Directory from the 
MacAppZPPC menu* Several dictionary files are run against 
your code using the MPW Canon tool. This performs the 
majority of the Toolbox renaming changes. 

4, You can run a .script called CreateUPPChecker to find out 
where all of your ProcPtrs live, because you will have to 
change them to create Universal ProcPtrs. because this 
script takes a long time to run, it s best to start It at night 
and return to it the next day (or the next, depending on 
how large your application is). 

By this point, most developers cut to the chase, try to 
build, and wade through the remaining compiler and linker 
errors, Well cover a few of them here* 

Changing those Pesky ProcPtrs 

One common hang-up in the migration to PowerPC is the 
need to replace ProcPtrs with Universal ProcPtrs for Toolbox 
callbacks* Well take a moment to describe how to change a 
ProcPtr through an example in MacApp 2 itself. 

The process goes like this: you have identified a ProcPtr 
that must be changed. You need to create a UniversalProcPtr 
for that procedure pointer, and use that UPP in iLs place. The 
UPP is a record that includes your procedure pointer, 
information about whether it’s compiled for 68K, and other 
housework. If you use that UPP repeatedly or in a modeless 
manner (for example, a TextEdit clickLoop callback), you 
might hang on to it; otherwise, you will usually dispose of the 


storage used by the UPP right after making your Toolbox call. 

For example, in MacApp 2 for PowerPC, when Finder 
printing, we use the Apple event Toolbox call 
AEInteractWithUser to make sure we get the user’s 
attention before putting up the print dialog box* This eall has a 
callback to our own code, so that we can idle while the Apple 
event manager is off waving its hand in front of the user. Here 
is the interface to the idle function* 

FUNCTION IdleFunctiun { 

VAR event: EventRecord; 

VAR sleepTxme: Lon&int; 

VAR digue eRgn: RgnHandle): BOOLEAN: 

Before porting to PowerPC, the address of this function 
would be passed directly to the Toolbox: 

FaiiQSErr(AEInteractWithUserl 

kAEDefaultTimeout. NIL, @ldleFunction)) 

For PowerPC, to create the UPP automatically, we go 
searching for the Toolbox file thai contains the definition for 
the relevant function, in the hope of finding a definition for its 
UPP and an automatic conversion function. In this example, 
the Toolbox file is AppieEvents * p; lo anti behold, there is an 
AEIdleUPP type and NewAEIdlcFroc conversion function 
provided for us. Because we no longer need the UPP when 
we are through, we wall dispose of it when finished. So, in 
order to call AEInteractWIthUser, we add a local variable 
and change the AEInteractWithUser code. 

VAR 

I d 1 ettPP: AETdteiIPP; 

idl^Upp NcwASldUfFroc (@idleFunetisml t 

I-ailNIL(idleUFF) : 

FailOSErr(AElnteractWithUser(kAKDefaultTimeout, NIL, idleUPF)): 

idleUPP := DispaselfRoutineDescriptor(idleUPP); 

When building for 68K, this changed code still w'orks, 
that's why it's called Universal. In fact on 68K it does the same 
thing as IjcTofc: NowAEIdlcFroc simply returns the and 
Dispose-IfRoutineDes crip tor does nothing. We are 
doing this extra work for PowerPC builds. 

Working with fp and fenv 

Another area of difficulty in porting your own code to 
PowerPC is likely to be Llie use of SANE or the 68881 (math 
coprocessor), if you do a lot of floating point math In your 
application. The good news is that the MPW porting scripts 
provided w ith MacApp2PPC make a lot of the changes for you 
to use the PowerPC MathLib through fp* p and fenv*p. Still, 
there are a few gaps. 

For example, the Mum2Str and Str2Num functions aren’t 
provided by MathLib. This bothered key developers porting 
MacApp2PPC, so these are now provided in UMacAppUtilities. 
If you already include UMacAppUtilities or UMacApp, you tun 
continue using NumZStr and Str2Num as is. Note that the suing 
parameter was changed from Dec St r to Str255. 
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MacApp 2 API Changes 

Aside from new interfaces and methods, the only major 
APT change is in TApplication ;GetActiveWindow, which 
now requires a Boolean parameter similar to MacApp 3. 
kFloatersOK and kF 1 oatersNotOK are defined for you. If 
you use this function, the returned window can be a floating 
window or a regular window. When in doubt about how you 
need it to behave, use kFloatersNotGK* 

Other important API changes include accepting 
Universal ProePtrs instead of regular ProePtrs (consult the 
previous description of converting to UPPs for help in changing 
your ProcPtrs)* 

Finally, UPatcITs mechanism for patching traps has 
changed to conform to the MacApp 3 1 mechanism, which is 
friendlier for PowerPC trap patching. If you use UPatch 
directly, you wall have to change the way you patch traps. 
Consult UPatch and MacApp 31 documentation for details. 

What's More 

We wouldn't be able to call ourselves good hackers if there 
wasn’t a surprise or two in the converted MacApp 2. One 
surpri.se is integrated support for floating windows. There is an 
unsupported trap-patched floating windows unit used by a lot of 


MacApp 2 developers, hut nobody wanted to wade through the 
gunk in porting that code, which is buggy anyway. So, Cheryl 
Lins and l looked at MacApp 3 Ts support for floating windows, 
and we hack-ported those changes into MacApp 2* It was easier 
than it sounds. The: result is cleaner, integrated floating window 
support in the framework, and no trap patching. Finally, code 
for Balloon Help was mixed in with the code that supports 
Apple events (which Anil Bajaj originally wrote as a patch to 
MacApp 2 using Keith KullhVs excellent PatehMaker). 

Apple events in MacApp 2 

Several API functions are added for Apple event support. 
Default support for the required Apple events 1 oapp 1 , * odoc 1 , 
1 pdoe 1 , and 1 quit 1 are implemented in TApp Heat ion. 

You can support Apple events very easily with 
MacApp2PPC You first create a new f aedt r resource in your 
<app>, r file specifying the event class, event message, and a 
CmdNumber (for an example look al the 1 aedt* resource in 
the MacApp * r file). The next and only other thing you have 
to do is override the TEvtHandler method DoAECotnmand 
and handle the appropriate CmdNumber (just like you would in 
DoMenuCommand, etc.). 
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DuAEICommand interface 

| If the handler can perform the apple event command it | 

( d<x!s so by either performing the command dirmty or | 
f by fisting a TCommaml. NOTH: Both liNTV Ptr’s are ) 

( actually a Plr to an Apple event record | 

FUNCTION TEvtHandler.DnAECommand ( 
aCradNurabe t r Crod Numbe r; 
message: UNtV Fir: 

reply: UN1V Per); TComuiand : 

In addition, there are two utility routines (in 
UMarAppUtilities): 

* MissedRequiredAEParameters checks the passed-in 
Apple event for any required parameters that we may have 
missed (called if handling Apple events, which should not 
have any parameter like the open application and quit events.) 

• ProcessAEDocList extracts the list of documents from 
the Apple event's direct parameter and converts each 
document's FSSpec record to an AppFile record; then 
calls the passed in routine (used to handle the open 
document and prim document events). 

Note: Your 1 size* resource must have its 
isilighLevelEvents Hag set in order for your application to 
receive Apple events. All of rhe MacAppZPPC example 
applications have this set already. 

Floating windows 

Floating window support was integrated into 
TApplication and TWindow. If you wish to add floating 
windows to your application, all you need to do is call 


InitUFloatWi ndow to ensure that the TFlua l Window 
subclass isn't dead-stripped. 

To make a window floating, make your window resource 
class name a TF1 oat Window instead of Window, and add 
the following to your . r file: 

0 include "Floattfindow.t* 

This adds the System 7.5 floating window WDEF to your 
application, so that you have floating windows on older Macintosh 
systems. If you’ve l)een reading this article and you’re skeptical of 
the value of object-oriented frameworks, notice the number of 
lines of source axle the developer must write to use floating 
windows (answer: one line, and that’s just to trick the linker!). 


New Budding Blocks 

Actually, none of these building blocks are new, but 
they've moved from the MacApp examples into the main part 
of the MacApp library. If you are already using them, you will 
lx* mildly relieved to know they have been ported to PowerPC, 
You can remove them from your application source code, as 
well as from your MAMake file (if you’re using MPW). 

These building blocks include- 
U Bel t e rbeedh :j c;kCni d VBL-synch tonized Feetflwck 

llFloatWindow Floating window support 

l IGrahilerTnicker 1 lml MacPaini hand-gral i xr thingy 

UMenu TView descendants that can appear in menus 

USyncliScn)3ler Scr<>1 ling muItiple views stiin i Itaneously 

l.rTearOffMenu What it says 

IJVUAssist Virtual User support (OK. I lied, this is 68K 

only) 
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Compiler-Specific Details 

IPs worth mentioning one compiler-specific detail for each 
Object Pascal compiler. 

Language Systems Pascal 1.0 works under MPW; that 
means it uses the MABuild tool to build MacApp applications. 
MABuild has been modified to accept additional options, 
including - [No] PPG to indicate 6RK vs. PowerPC code 
generation. That’s all there is to it! When a future version is 
provided as a plug-in for the Symantec IDE, the build process 
will use the features in the IDE more directly. 

Metrnwerks Code Warrior Pascal works within the 
CodeWarrior IDE so the IDE is used for building applications, 
but MacApp 2 still requires compiling resources under MPW. 
Although there is a Rez plug-in for tile CW IDE, MacApp 2 still 
relies on a custom MPW tool called PostRez. To make life 
easier for the CW Pascal user, the revised MABuild tool also 
accepts a * iNo] OnlyResources option, to specify that you 
wish to compile (and PostRez) only resources for your 
application. This step is still annoying enough that Per 
Bergland and Roger Brown are seeking ways to remove or 
simplify the PostRez step, by developing a plug-in tool. Their 
dedication captures die spirit of what is MacApp2PPC 


And Finally 

Well over a dozen applications have !>een ported to PowerPC 
using MacApp2PPC, and many more are currently Ix/ing [ported. 
Meanwhile, the world of software frameworks is constantly 
shifting. Component technology is moving rapidly to your 
neighborhood. MacApp2FPC is currently serving the needs of 
Macintosh Object Pascal MacApp 2 developers wishing to have 
native applications on PowerPC. Where it goes depends on the 
developers who use and nurture this version of the framework. 
There is no commitment except the one each developer gives 
to it. Some developers are sufficiently motivated to continue 
evolving MacApp 2 in manners consistent with the drive 
towards MacApp 3.3 as iLs flagship, and in moving developers 
toward OpenDoc as the future. 

Developers in the cooperative arc considering adding drag 
and drop support as an initial step toward OpenDoc container 
support, removing the working directories dependency, and 
removing the PostRez step mentioned earlier If you wunL to 
make a difference and help out in making these changes, you 
can join the "MacApp2PPC-List M Internet mailing list by sending 
e-mail to macjordomo@afar.med.cornell.edu with “subscribe 
MacApp2PPC-List Your_Name M in the body of the message; 
send e-mail to amold@lumina.com if you need help. Maejordomo 
(http://leuca.med.cornell.edu/Macjordomo) is a iLsLscrver that Michele 
Fuortes ported to PowerPC using MacApp2PPC in about 5 
evenings. You are also highly encouraged to subscribe to the 
comp.lang.pascal.mac newsgroup on the Internet to stay in tune 
with the latest goings-on in Pascal for the Macintosh. 

Also, check out the cooperative's Internet world wide web 
pages at: http://www]umina,com/amold/MacApp2PPC.html 

You'll find some interesting things for MacApp 2 at this 
site, including the latest version of MacApp 2 for PowerPC, plus 
WASTE text engine support, QuickDraw GX printing support, 
and more. 

What this cooperative brings Object Pascal MacApp 2 
developers in the future is yet unseen. Stay tuned. 
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MacTech Magazine!! 

... now in THINK Reference format! 


MacTech CP -ROM, 

Volumes 1-10; 

Over 1230 Articles. 

All 115 Issues, 
including all of 1994. 

All the Source Code. 
THINK Reference 2j0. 
Working Applications. 
Full Documentation. 
Demos for Developers. 
And More!! 

' When \ designed THINK Reference, 1 envisioned endless 
databases my fingertips. MacTech has doubled the 
information that is jus! a mouse click away/’ 

- Darrell lelibmc, Formerly of Symantec, 
Author, THINK Rtfemux 2.0 

“The Cl) strikes me as an impressive and very useful resource. 
The only disadvantage I 've found is that each answer the 
databases yield exposes me to so many more issues, that [ 
find myself exploring the articles for the sheer wonder of it, 
and thus putting off die real coding I should be doing. 

- Nicholas De Metio 
MacTech CD Beta Jester 


Fur Macintosh 
Programmers £ Developers 

Tech 

MAGAZINE 


Voice: 805/494-9797 * Fax: 805/494-9798 
Internet: custservice@xpiain.com 
eWorld: MZCustSvc • AppleLink: MT.CUSTSVC 
CompuServe: 71333,1063 
America Online & GEnie: MACTECHMAG 


/ 50 MB of MacTech Magazine articles, Volumes 1-10 

Every article, 1230+ of them, from ail 115 issues of MacTech Magazine printed 
from 1984 through 1994. Articles ranging from Assembly to BASIC, C to Pascal, 
Forth to FORTRAN and more. Arid the articles are in THINK Reference! 


^Hyperlinks to Inside Macintosh Databases of THINK Reference 

The articles have hyperlinks to relevant portions of the Inside Macintosh 
databases of THINK Reference, For example, if you are looking for 
information on Aliases, look at the MacTech articles on Aliases and use the 
hyperlinks to jump to the Inside Macintosh entry for the Alias Manager, And 
now, with the articles in THINK Reference, you can do free-text searches 8-10 
times faster than you could previously with On Location 1 * 1 2.0. 

y 100+ MB of MacTech Magazine source code examples, samples, 
and utilities. 

These are the files Lhat go with die magazine - the code dial the articles arc 
talking about. Use them in your own applications, w ith no royalties! 


y A fully-capable version of THINK Reference 

Including Inside Macintosh Volumes 1-6(7 MB). 


y Sprocket - MacTech’s liny Framework- 

Build your simple application using a lean, mean application framework. 
Experiment with new code without having to build a whole application 
around it! 


y 80 MB of FrameWorks, MacApp®, 
MADA and SFA articles, files and 
source code. 

The most complete set of Frameworks 
archives known. 

y Apple APIs, Utilities, and SDKs 

Including: Universal Header Files, Discipline, 
Macintosh Drag and Drop SDK, MacsBug, 
Telephone Manager SDK, Thread Manager 
SDK, TrueEdit 1.8 and and more. 


FREE! 

THINK™ Reference 

Symantec's THINK Reference 
2.0, Complete on-line guide 
to Inside Macintosh, Vol. I-VI, 
with cross referenced index, 
detailed information of each 
function, procedure and 
detail needed when 
programming the Macintosh. 


SYMANTEC. 


y Ariel Publishings Inside HAS I Con disk 

...and other related BASIC programming information and tools. 


y 15 MB of Special Demos relevant for developers 


MacTech CD ROM, Volumes M0: 

$49 plus shipping and handling. $39 plus shipping and handling for 
upgrades from any previous version of Lhe CD. 
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by Stephen Humphrey, VP Engineering Acorde Corporation 


Cyberdog, the OpenDoc Internet Components 


The future of Internet 
surfing is OpenDoc 


Cyberdog is the code name for Apple 
Computer's OpenDoobased Internet 
components. This article provides a 
10,000-foot view of the Cyberdog 
architecture and a cursory introduction 
to the must important parts of its API. 

Cyberdog will include components 
which provide Web browsing, SMTP and 
POP mail, Usenet News, FTP : Gopher, 
and Telnet These components provide 
the sort of functionality one expects from 
Internet apps today, plus strong mutual 
integration with one another, and with a 
universal log, which keeps a historical 
record of the user's actions, and a 
notebook* which stores pointers to ihe 
user's favorite places and people. For 
instance, Cyberdog's integrated SMTP 
and POP mail system (see Figure 1) is 
fully MIMF-capable; addresses may be 
stored in the notebook for easy access; 
and any Cyberitem may be sent as an 
enclosure. The News reader shows the 
familiar display of newsgroups and 
messages (see Figure 2), and any icon 
can be dragged to the notebook. 
Cyberdog is designed to improve the 
Internet experience for MacOS users by 
closely integrating the various 
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Figure 2, Ihe News reader 


Stephen Humphrey - Stephen Humphrey is Vice-President of Engineering for Acorde Corporation, an Internet-components 
developer An eleven-year Macintosh veteran, he is also the author of OgenOtK Developers Guide: Macintosh Components, 
due February 1996 from Hayden Books (h ttp; www, m tp. com / hay den AecW h He can l>e reached at shqmphrey@acorde.com. For 
more information on Gyberdog and OpenDoc, contact t he famous Jim Black, Open Hoc Fvangelist, at hlack@appIexom. 


Fkbruakv 1996 • MacTfxhMagazinf 


Cyberdog, thk OpenDoc Internet Components 


35 






























































components with each other, with other applications, and with 
Lhe desktop. Apple will encourage third-party developers to 
extend and replace the base Cyberdog components by fully 
documenting the Cyberdog API and architecture. 

As I write ibis article, Apple plans to distribute a sneak 
preview of the shared libraries which make up Cyberdog on 
the OpenDoc Developer Release 4 CD [in this issue]; the end- 
user release of the Cyberdog components is currently 
scheduled for May 1996, 

ihe Cyberdog components factor their Internet responsi¬ 
bilities into three major areas: Viewers, Services, and ConLexL 
facilities. Viewers are responsible for displaying the myriad 
data types commonly found on the Net, like JPEG and HTML 
Services manage the protocols used for transporting the data 
types. Context facilities hold the history of the user’s 
interaction and help the users keep track of their favorite sites, 
newsgroups, and mail addresses. 

Viewers are OpenDoc Pari' Editors 

One of the most exciting aspects of Cyberdog is its extensive use 
of OpenDoc. Cyberdog depends fully on the OpenDoc 
architecture for displaying and interacting with Net-borne data. In 
fact, every part of Cyberdog that has a user interface! Ul) is 
implemented as an OpenDoc pan. Even those components which 
do not have a ITT are implemented as SOM objects, so again they 
behave similarly to OpenDoc components. This dependence on 
OpenDoc means that a Cyber-aware Viewer you write will 
automatically benefit from the strengths of the OpenDoc 
architecture. So, for example, if you write a CylxTdog-savvy Stock 
Ticker, your users will be able to display dynamically-updating 
information about their portfolios in any OpenDoc container. 

Cyberdog viewers are first and foremost OpenDoc viewers. 
To show a data type in Cyberdog, you first implement an editor 
based on ODFart. All of a regular OpenDoc part's methods 
are required, and the part editor uses the standard OpenDoc 
event, layout, and storage facilities. To add the functionality of 
Cyberdog, you add an extension to your editor which inherits 
from Cyber Part Extent ion. 

Cyber Pa rtExtension is a virtual class which provides 
the methods with which the other CylxTclog components will 
interact with your viewer. You will write an extension which 
inherits the base functionality of CyberTartExtension but 
which also knows about rite particular details of interacting 
with your editor. So for example, if you have already written a 
JPEG display parr using OpenDoc, you will write a 
CyberJPEGExlension which provides your part with the 
additional capabilities of retrieving the JPEG data from the Net 
instead of just from your OpenDoc Storage Unit. 
CyberParlExLen.siott is a standard ODExtension, so you will 
provide your extension to Cyberdog via the standard 
ODFart; : HasExtension () and ODFart;: Get Extension^) 
mechanisms. After your part is initialized but before you create 
your first display frame, Cyfxrdog will tell your editor to use a 
Cyber Service to retrieve its data. 


CyherServkes Encapsulate Internet Protocols 

A Cyber Service is the base class which manages a single 
Internet protocol. The basic Cyberdog components include 
CyherScrvice implementations for HTTP, FTP, Gopher, Telnet, 
and the local file system. Notice that CyberServices represent 
transport protocols and not data types, so there is an 
FTP Service, not a JPEG Service. A C y be rServ ice's most 
important role is as a manager of a lew other classes of objects 
which actually implement a full Internet protocol, particularly 
the Cyber Item and the Cyber St ream. 

A Cyber It Gin represents the address of a piece of data on 
the Net. in its simplest form, it can be thought of as an 
objected-orientetl wrapper for a URL In practice, there is 
nothing Lo stop much more advanced capabilities in a 
Cyberltem, such as complete database queries. Cyberltems are 
portable; they can be saved in your Storage Unit and 
^instantiated later. If you are implementing a viewer which can 
contain one or more links to outside data, such as an HTML 
viewer, you will save Cyberltems in your Storage-Unit as part of 
your own content model, retrieving them when necessary' based 
on action from the user. Cyberltems have no inherent UI, so 
they inherit from SOMObject instead of ODFart, 

A simple example of a Cyberltem s behavior Is shown by 
a CybcrRuilon, a simple Cyber-savvy viewer which comes 
with Cyberdog, A Cybernation is an OpenDoc part which 
behaves as a button (surprise!); it can be displayed in any 
OpenDoc container, can display a title or a picture on its face, 
and can be clicked on by the user. Internally, a CybcrRutton 
holds one Cyberltem, When the user clicks on the 
CyberButton, the button calls the Cyberltem s Open() 
method. This is a fire-and-forget call; the OyberBulLon is not 
responsible for any additional interaction with the Cyberltem, 
The Cyberltem is free to take any appropriate action, the most 
common of which Is to open a viewer to display the data 
pointed to by the Cyberltem, 

As a Cyber-savvy viewer, you become interested when the 
Set Cyber It em() method of your CyberPa rtExtension is called. 
This tells you that you are being opened hccau.sc the user Ftred a 
Cyberltem, and you arc provided a reference to that Cyberltem, 
Your most common action then will lx ro ask the Cyberltem to 
create a CyberStream through which you will get the data lo 
display; to do this, call die CytxTJlems CreateCyberStreamO 
method, and it will return a CyberStream. 

CybekStreams Provide Clean Data to Viewers 

A CyberStream implements the actual passing of data from a 
protocol to a viewer. After receiving a CyberStream from a 
Cyberltem, you will tell the CyberStream to either Open() or 
OpenWIthCallback (). This call tells lhe CyberStream that it 
should immediately begin downloading the data. It is the 
CyberStreanVs responsibility to begin retrieving the data 
asynchronously and to store it unril you ask for it. 

If you opened the CyberStream by calling Gpen(), you 
will poll it for data by calling its Ge l_S LreamS tatus () 
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Take a Power Trip to a 
New Realm of Developing 





Powerful Tools to Take You Where You Want to Go 

YfotiVe heartl about (he speed of DowerPC and you’re thinking about the cool 
applications ml content tilts amazing new chip will allow you to create. Read 
on to learn more about the tools that will take your development wliere 
you want to go, fast. 

Prototyping HyperCard' 23 provides a robust prototyping 
and development environment for professional developers. It is 
also an easy-to-use tool for building a wide range of custom soft 
wane applications for Macintosh", from training simulations to 
information kiosks. And now its accelerated for Power Macintosh' 

PowerPC and 68K Compilers MctfOWCrks Codc^fiGr 
Gold is die industry’s first native development environment for 
both the PowerPC and 68K based Macintosh environments. You can 
easily target die entire Macintosh installed base with code created 
using one development environment running at lYnver Macintosh speeds. 
Cross-Platform Multimedia Create innovative, interactive multi- 
media titles which will play on both Mac OS and Windows systems. Give 
users the ability to cruise up, down and around objects. They can even zoom 
in and pick them up No wonder QuicklImc“VR Authoring'lbols Suite v.1.0 
has won so many awards, including MacUser Magazine^ TSddy ' for 
Breakthrough technology of the Year. 

There's a wide variety of development tools available through die Apple 
DeveloperTbols Catalog. Check it out. Developing on the Macintosh platform 

has never been easier or faster. And now widi cross- _ 

platform flexibility, ilk smarter than ever. 


QuickTime VR Authoring Tools Suite v.1.0 

Develop crass-platform multimedia products with 
QuickTime VR content 

$495 

This suite includes complete documentation for planning, designing, 
photographing and capturing content. QuickTime VR uses break¬ 
through compression/decompression techniques which produce 
small file sizes. And there’s no special hardware required. 


How to Order 


Metrowerks CodeWarrior Gold 

A complete development solution for C/C++ 
arid Pascal programming 

$399 

Runs native and cross-compiles on 68K or 
PowerPC platforms, ensuring tliat as you go 
forward on Power Macintosh you also conserve your investment in 
your installed code base on 68K Macintosh and your code base 

remains backward-compatible. Lets you compile, 
link, and debug 68K software at full native speed 
on a PowerMac", and build PowerPC versions of 
your software on a f>8K Mac. 


HyperCard 2.3 

A robust prototyping and development 
environment accelerated for Power Macintosh 

$99 

Comes with powerful scripting tools including 
AppleScript Runtime built-in, a modeless script 
editor, hypertext support, debugging tools, new 24-hit color painting 
tools, Automated button 'lasks, and many other features. Stacks can he 

saved as stand alone, double- 
ciickable applications von may 
distribute without software 


Tn order call: 

1800 282-2732 


And ask for a free cop)' of the Afpie 
BmhjxT'Hxis Catalog. 

Visa, MasterCard Lind AM DC accepted 



royalty fees. 



1995 typii! Computer, ino, AwjIc. |m Apple Ichio. Macliflosh, Power Macintosh, HyperCard, AppfefccriiKl and (JiitokJiriw am neg&torcd Iradnmjwfts of Aopto Compirter, Inc. PowerMac Is a irademark of Apple Computer. Inc PowerPC is a iradematk ol 
IrtlemnfUinal Btistofliw Machines. Cftqioraifinn under license itwmlrom Offer expires 17A1J9G Prices above do not bauds tax and sliipoing Prices and (wCHjutJ:; are subied to change wthocfl milks To place enters Irom Canada call 1-BCKHSif-tKfiU; 
outside Canada call 1-716471-6555 or lux iiiuumcs, 1u !■ 71.6-371-6511 jjjy; 


















ALL BU 6 S ARESTUPIP. 

But spending tedious hours trying to track them down Is dumber stilt. 
Why not let a toot do the work? QC can find many of those mistakes 
automatically. Ever write data beyond the end of a memory block? 

Ever rely on a handle that was purged? Ever call DisposeHandEe on a 
resource or ReteaseResource on a handle? Sure you have! Maybe you 
just haven't found out about It yet,.. QC finds these errors and more. 

BECAUSE: VOU NEED: 

Every programmer makes mistakes. 

All programs ship with bugs. 

Marketing just cut the beta 
You could use some sleep, 

QC is cool and, unlike other development tools, QC is easy. Try it FREE: 

I, Connect to our web site 
Z Download QC (less than 200K) 

3, Send us email to get a serial # 

4, Run the installer 

5. Run your program 

6. Press shift-optic n~q 

,J I only have 6 non-Apple Control Poods on r We woukfnY sftJp a product 

my development machine. QC fe one of without QCs approval" 

them. 'Ntiff said.* 1 -Mate Gross, Chris Corporation 

-Bilf Goodman, Compact Pro author 

NOW POWERPC NATIVE ? EXISTING USERS UPGRADE FREE! 

Oryx Technology 70II 27th Avs Bradenton, FL 34209 
Tel: 941.795.7801 Fa* 941.795.5*01 
Web. hopd/www.std.com/onyKtech/ 
AGL: OnyxTecti AppleLink; D2238 CIS; 70550,1377 


method. The must interesting replies are kD at a Avail able 
and kDownloadComplete. If you opened the CyberStream 
by calling its OpenWi thCal Iback {) method, then the 
CyberStream will notify you whenever data is available by 
calling the notification method you register. 

Any time the CyberStream lias data available, you can request 
a chunk of data from Lhe stream with the call GetBuff er (). 
When you are finished processing the data, you must call 
ReleaseBuffer 0 - If you are using a callback method to notify 
you when data is available, you must remember that this 
notification may happen at interrupt time; you will not be able to 
allocate memory, draw to the .screen, or perform any other action 
which is not interrupt-safe. However, ii is okay to set an internal 
state which will get and process the data later, such as at idle time. 
The CyberStream may only have a limited number of buffers, so ii 
is a good idea to release them as soon as you are able to. You will 
continue calling GetBuff er () and ReleaseBuf fer () until the 
CylxaStream reports it is finished downloading, 

CyberStreams are responsible for parsing rhe data stream and 
removing any protocol-specific headers or similar data blocks in 
the stream. This has the advantage of providing the viewer with 
a consistent stream of data regardless of the dam's transfer 
protocol on the Net. So for example, your JPEG Viewer need not 
care whether the Cyberitem it receives is really a Gopherltem, an 


FTPItem, or a Fiieltem; regardless of the protocol the user chose, 
the JPEG stream you receive will be the same. 

One limitation of the method described above is that 
sometimes a Cyberitem doesn’t know what kind of viewer it 
should open. For example, a Web item cannot open an 
appropriate viewer until it knows lhe kind of data at which it is 
pointing, that is, unLil it parses the HTML and finds an 
appropriate datatype tag. In this case, the Cyberitem will 
actually open the CyberStream and start it downloading even 
before the real viewer is opened. The Cyberitem will also 
open a special OpenerPait that will display the download status 
until the real viewer can be determined and opened. However, 
as a viewer you will not know or care thaL the stream has 
already Ixen opened; you wall ask the Cyberitem to create a 
CyberStream, ask the CyberStream to open, and begin polling 
as usual. 

As of now, CyberStreams are designed primarily to pass data 
in one direction. This is decidedly unhelpful for some protocols 
which depend on more interactive communication between the 
viewer and the stream. For example, the telnet protocol cannot 
he implemented efficiently using CyberStreams. Thus, when a 
Tdnetltcm (a telnet Cyberitem) asks a TelnetVlewer to open, the 
TelnetViewer never requests a TelnetStream. Instead, it just fully 
implements the telnet protocol within the viewer by asking the 
Tdneiltcm for its connection information and creating die 
connection itself, Since no CyberConnection object exists, this 
means implementing these types of protocols is fairly tedious 
today. This is a great opportunity for either a future version of 
Cyberdog or for a smart third-party. 

Context Facilities Tie the Parts Together 

Cyberdog provides several built-in context facilities which unite 
the various components into a seamless Inrerner workspace. 
These include a common Connect dialog, a Preferences pafiel, 
rhe Log, and Notelrooks, Each of these is managed through the 
single Cyber Session object. 

The CyberSession is responsible for die overall integration of 
the Cyberdog components. It is similar in purpose to the Open Doe 
session object. ODSession, although it is different in the particular 
services it provides. There is at most one CytxrSession for each 
ODSesston. The CyberSession is die main facility through which 
Viewers will request various Cyberdog objects. It is also the facility 
through which standard GpenDoc containers will lx able to add 
the Cyberdpg menus to their menu bar. Among its responsibilities, 
the CylxrSession checks the Cylieniog libraries folder to see which 
CyberServices are available. This is what allows the run-time 
addition of new services to Cyberdogs repertoire. 

CyberServiecs may provide a Connect panel. If provided, 
this part allows the Cyberdog Connect dialog to display 
protocol-specific fields for any service available to the user. In 
operation, the Connect dialog is reminiscent of rhe 
pre-Systcm 7 Control Panel dialog, with .scrolling icons on the 
left and individual panels on the right. Since the panels arc 
implemented as regular Open Doc parts, a service which 
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implements a new protocol can easily provide a panel for the 
CyberSession to display to the user Such a Connect panel is 
implemented by adding a CyberPanelExtension to a 
regular part subclassed from OQFart. 

Similarly T any CyberService can provide a Preferences 
panel that the CyberSession will display in the Cyberdog 
Preferences Dialog. A Preferences panel, too, is implemented 
by adding a Cyber Panel Extension to a regular part 
subclassed from ODPart. (This implementation of the 
Cyberdog dialog boxes provides one of the best non-document 
uses of OpenDoc to date; it validates Open Doc as more Lhan 
just a compound-document architecture.) 

To provide an historical context for the user's actions, 
Cyberdog provides a universal Log which tracks where the user 
has been on the Net, The user can show the log, display its 
items hierarchically, alphabetically, or historically, and return to 
places in it by simply clicking on Lhe place's icon (see Figure 
3), A Viewer posts a new item on the log by providing a 
Cyber!tern (and optionally, its hierarchical parent) to the 
CyberSession J s AddCyberltemToLog () method. 
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Figure T lhe Log window 

lhe user may also save one or more Cyberdog Noielxx)ks 
(see Figure 4). These simple lists of Cyberitems have a single¬ 
level folder system in which Lhe user can organize favorite 
places and people. The user identifies a default notebook, and 
Viewers may add an item to this default notebook by simply 
telling the CyberSession to AddCybe rltemToNotebook (), 
More typically, Viewers allow the user to drag CyberTtems to a 
Noi ebook using the OpenDoc drag-and-drop facilities (so the 
user can drag e-mail addresses, newsgroups, Web sites. Gopher 
directories, and telnet connections rig! it inlo a Notebook). Like 
other pans of Cyberdog, the Notebook is designed to implement 


the minimum functionality required by a beginning Internet 
user; ii is ripe for replacement by an enterprising third-party. 
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Figure 4 . We Notebook 

Where To Go From Here 

By the time you read this article, the Cyberdog components and 
SDK should be available on the OpenDoc DR4 CD, The SDK is 
quite preliminary, but should be sufficient to gel .started with 
developing for Cyberdog (especially if you're not afraid to bleed 
a little). Various lislservers have been established to facilitate 
Cyberdog discussion. Mail a message Lo cdog@apple.com with 
subject “DEV-INFO' 1 for more information. 

Apple has done a commendable job of designing 
Cyberdog, From its foundation. Cyberdog's architecture 
permits and even encourages third-party developers to replace 
and extend it. Since it is still alpha-quality code, expect some 
pain. However, developers who learn to walk the 'dog now 
might discover opportunities and markets that will be harder to 
find later. If you start early, die ’dog will probably bite you 
occasionally; but once you’ve learned to handle it. you’ll be 
able to cuddle up close. * 

Mt 
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By Gerry' Kenner ; University of Utah, and David Kenner, Phone Directories 



Using OpenDoc With Object Flow System (OFS) 


Get up and running 
with OpenDoc 


will appear (SelectPint) asking for rhe name. The name will 
then he placed into persistent storage for access by the 
I mage? art. The name will i>e retrieved by the I mage Pa it and 
displayed in iLs window . 


Introduction 

OK, You have taken your Cl) containing 
OpenDoc, downloaded the necessary 
documents, and have used Pan Maker to 
create a generic program named 
HelloPart. You definitely have a warm 
feeling of competence because this could 
not have been done without doing 
everylfling precisely as the instructions 
called for (remember that SOM file which 
you failed to name in version 1 Ixxmsc 
you overkxjked the instruction to do it?). 
What do you do now? Start reading the 
documentation? Heaven forbid. At least 
not until you have a better idea about 
what OpenDoc is and what it can do. 

We propose to teach OpenDoc 
using rhe following steps: 

1. Define OFS. 

2. Explain what OpenDoc is and 
provide a glossary of major terms. 

3- Do an overview of Apple's 
Sample Part COO project, 

4. Outline a tutorial project which will 
create a module consisting of two 
parts. When completed, this project 
will show a menu bar wilh an item 
for selecting the name of a PICT file 
(ImagePart). A SFGetPile dialog lx>x 


OFS 

OFS (Object Flow System) is an intuitive method for doing 
program design. As our CAD tools, we use a flow-charting 
program (MacFlow"", Mainstay) and a word processing program 
with outlining capabilities. An introduction to OFS can be found 
in the December, 1993 issue of MacTech (see Bibliography, 
below). Three unpublished articles dealing with the subject can 
be obtained upon request via email The details of the outlining 
level of OFS are given in Appendix A at the end of the article. 

OpenDoc 

OpenDoc is a development platform which takes binary code 
fragments (objects) and integrates them so they will interact 
with each other. Basically, there are four types of code 
fragments involved: user, third-party, libraries and platform- 
specific (drivers). What is earth-shaking about the OpenDoc 
concept is that it does not require source-level code. 
Translated, this means that i 1) you can program with whatever 
language you wish as long as file OpenDoc interface rules are 
followed; (2) changes can lx 1 made in OpenDoc without having 
to recompile the entire program; and (3) the code is portable 
and can be distributed in binary form. 

Where to Find OpenDoc 

The latest version of OpenDoc can be obtained by sending 
a message to o pend oc@app le I i n k. a p pie .com . Additional information 
about OpenDoc is available via the World Wide Web pages at 
http://wwwanfo.appl0.com/opendoc/. The home pages of rhe 
Component Integration Laboratories (Cl Labs, http:// 


Gerry Kenner and David Kenner - Gerry Kenner is a researcher at the University of Utah, Salt Like City, IT. His major 
goal is developing better methods for doing program design. David Kenner is a Macintosh programmer at Phone Directories. 
Orem, UT. They can he reached via email at Gerry. Kenner# m.cc ,u La 1 1 .edu. 
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wwwxilabs.org) are a rich source of information about all aspects 
of OpenDoe. [And, there’s the CD in this issue!] 

OpenDoe and SOM 

Figure l shows an oversimplified view of the relationship 
between OpenDoe and the other components of the Macintosh 
system. The figure was derived empirically and is probably not 
completely accurate, but it is useful as a working model. Note 
that ' SOM stubs” refers to the SOM interface. 



Figure F OpenDoe, SOM and user created parts . 

Glossary 

Here are some terms you will need to know to understand 
the material which follows. 

OpenDoe - A development platform designed to seamlessly 
coordinate binary code fragments into larger entities 
corresponding to present clay applications. Although 
OpenDoe is serviceable as a name, a functional name such as 
Object Manager or Object Integrator would have been ttetter. 
Document - Collection of parts or objects. Basic units used by 
OpenDoe, 

Part - Corresponds to the term “object". Consists of content 
(definition) and part editor (executable code). 

Content - Also “part content". The portion of a pan which 
describes its data, he. the object definition. 

Part editor - Executable code of a part or object. 

Frame - Total virtual area which can be used to display a part. 

A facet Is displayed in some or all of the frame. 

Facet - Total actual area which can be used to display a pan. A 
facet corresponds to a portion of a window or printing 
canvas where a pari is expected to image itself 
Focus - Designation of ownership. A focused window is one 
which is selected and ready to be drawn in. 

Storage unit - An object for storing persistent data, i.e., data 
which is shared between parts. 

Draft - Versions of a. document maintained with incremental 
deltas. 

Module - A group of parts. 


Sampi^Part 

We will now look at how an OpenDoe part is put together and 
executed. We will do this by looking at the contents of the 
SamplePart project, followed by some diagrams which show 
how Lite different components of an OpenDoe project interact 
with each other. 

SamplePart Project Window 

Figure 2 shows the Symantec project window for the 
SamplePart part. What are all these files? ilie System libraries 
are the PowerPC equivalents of the MacTraps, ANSI, Sane, etc. 
libraries of the 68k Macintoshes, The OpenDoe libraries and 
OpenDoe utilities provide code which OpenDoe needs in order 
to operate. We can safely ignore these at this time. The 
resource directory contains the resources used by the 
SamplePart part. These include the About SamplePart dialog 
box, and some strings and information required for external 
accessing of the part and its storage. This leaves the Sample 
Part and SOM interface directories. 



Figure 2 . Symantec C++ project window for SamplePart. 

The code which is of concern to us in this article arc 
som .Samp 1 eFart . cpp T located in the SQM Interface 
directory, and SamplePart .epp, in the Sample Part directory. 
Examination of the contents of the s om_Samp 1 apart. epp file 
shows that it consists mainly of interface or stub calls to the 
corresponding C ,+ methods in the SamplePart. epp file. 

Reference to Figure 3 shows how this works, Thu SOM 
interfaces are the clearing points for receiving and sending 
messages to SOM, This is done by programming in the IDL 
(Interface Definition Language). The programmer can write the 
entire part in IDL, or alternatively, write interface code which 
relays the SOM messages to code written in higher level 
languages, such as C++, Figure 4 shows an example of how 
this works. 
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Figure 3- Closer look at SOM relationships. 
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Purge 


In this case, SOM sends a message to the SOM interface 
requesting that the SamplePart parr be instantiated. Thus: 


Instantiate 

SamplePart 


som -Samp loPar t _ 
somlnit 


r :«fPart 


SamplePart:: 

-fPart 



Figure 4 . Program flow for instantiating SamplePart, 

Other files in the SOM interface and the Sample part include 
SampleCollections.cpp, SamplePartUtils.cpp, 
SamplePart Init.eppand som SamplePartlnit.cpp. 
SatnpleGollect ions ■ cpp and SamplePartUtlls * cpp 
contain functions and classes with methods for doing things such 
as copying strings and making conversions between global and 
load coordinate systems. These classes do not interact directly 
with the SOM interface code. As their names imply, 
som_SamplePartInit.cpp and SamplePart init.cpp 
contain some short initialization sequences, 

Startup Code 

Let’s take a closer look at what happens when an 
OpenDcx; part is started up. This is illustrated in Figure The 
first column denotes messages received from SOM. The second 
column denotes the instantiation of an object of SOM class 
som_SamplePart and shows execution of some of its 
methods. Similarly, the right-hand column shows the 
instantiation of an object of the 0+ class SamplePart and the 
execution of many of its methods. The diagram has been 
simplified by omitting some messages. 


Figure 5. Start-up sequence for SamplePart 

Rxcept where method calls are made from within the 
SamplePart object (e.g. Initialize is called by 
InitPartEromStorage), all activity proceeds from left lo 
right, For example, the first message received results in the 
instantiation of an object of the SOM class som_SamplePart. 
The second message then calls the somlnit method of the 
soTn_SamplePart class which instantiates an object of the O 4 
class SamplePart. Calling of constructor methods is not shown 
as it is assumed this happens when an object is instantiated. 

Everything Is pretty straightforward here. The steps for 
creating and displaying a pan are opening it followed by 
creating a window. Space for displaying the frame is added, 
after which a facet is created. The part is then fine-tuned and a 
copy is sent out to memory (Externalize). The program 
then goes into idle (HandleEvent), The screen is drawn as 
an update event during idle (Figure 6), 


SamplePart 1.0 10.29/95 



figure 6. The SamplePart display. 


Shutdown Code 

Figure 7 shows the operations which occur when the 
SamplePart part is shut down. Note that the objects of classes 
gom_S ample Part and SamplePart were instantiated at 
startup and the process is not repeated. 
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Figure 7. Shutdown operations (simplified for clarity). 


[n this case, the window (not shown), frame and part are 
all activated, and the facet is removed. Storage is then released 
and the destructor method is called. 


Tutorial 

Our next step is to design and create a module named KSS using 
OFS. The module will have two parts named ImagePsrt and 
Selec t Part respectively. This is the first step towards creating 
a full-fledged image analysis program tor measuring surfaces and 
areas. Hence the name of the ImagePart pan, which will 
eventually become the container for die completed project. 

Intuitive logic plus a general perusal of program design 
books indicates that there are approximately four levels of 
programming. These arc: 

* Planning level 

* Prototyping level 

* Flow diagramuting level 

* Programming level 

Using terminology borrowed from Goldstein and Alger 
(see Bibliography), we break the planning level into two 
further divisions, the reference and solution sublevels. See 
Figure 8; the border shadow denotes the presence of subcharts. 



Figure 8. The upjrermost level of the OFS system , 


the name of a file. The name of the file will be stored in 
SelectParts persistent storage. Program execution will then return 
to the ImagePart part which will retrieve die name from SelectParts 
jxjrsistent storage after which it will dispose of SeleaPart. 

The ImagePart part will then display the name of the 
selected tile in its frame. 

Prototyping Level 

The prototyping level is where the project begins to get 
some substance. In practice, prototyping is done in many 
ways. These range from the use of prototyping programs such 
as Marksman". AppBuilder*, Visual Architect" and Rational 
Rose" through various CAD-type systems such as the one we 
use here, lo miscellaneous notes and ideas kept on napkins, 
scraps of paper or die brain of the program designer. 

The root chart of die prototyping level is shown in Figure 9. 
ft has separate boxes for the two parts of the module. The menu 
bar, display and diagram categories of the ImagePart and the 
diagram category of the SelectPart are shown in Figures 10 to 13. 


& 

§i ImagePart 

\ Menu Bar f \ Display A 

f \ Diagrams yr 



#> 

S*t»CtPart 

\ Diagrams / 



Figure 9. Root display of the prototyping level. 


Figures 10 and 11 provide general ideas of what the menu 
bar and the screen display will look like. The layout of die 
menu bar is particularly important because much of the 
program's flow is determined by the layout. In a full-scale part, 
there would also be diagrams showing the layout of various 
windows and dialog boxes. 


Open Piet 

Figure 10. Proposed menu bar add-on. 


Planning Level 

Reference sublevel, The template for building the 
ImagePart and SelectPart parts is die SampIePart parr of the 
Symantec 0% version 8 demo projects. 

Solution sublevel, the ImagePart part will be placed in the 
Apple container jxirt or else run as a standalone part. The frame of 
the ImagePart part will contain the words "Hello World”. 
ImagePart will add an additional menu to the menu bar containing 
a single item. Open Piet When lire 1 menu item Open Pitt is 
selected, the SelectPart pan will lx* instantiated The Selection pan 
will display a SFGetFile dialog box from which the user will select 


f Y 

PracticePict 

X______ 

Figure 11. Proposed display. 

Figure 12 shows the proposed program flow for the 
ImagePart when the Select File item of die Image menu is 
selected. Note the instantiation of the SelectPart pan. 
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When the Select Part pan is instantiated, it is initialized, 
followed by the sequence of events shown in Figure 13, 




figure 15, Flowchart for SelectPart. 


Programming Level 

This is where the actual code is written. Ordinarily, this 
section is empty because the programmer would refer directly to 
the project files for information. Tills is particularly the ease since 
the browsers and editors which are provided with the compilers, 
greatly simplify the task of finding one’s way around Lhe code. 

In this case we have made an exception because we are 
demonstrating how to set up a simple program showing how to 
use multi-parts as well as accessing persistent storage. As was 
done above, the presentation is made in two parts, one each 
for l mage Pan and Select Part. 


Flow Diagramming Level 

Ai this point iL is time to start laying out how the module is 
to be implemented* This is where we take our existing and 
third-party code and combine ii with a knowledge of what types 
of programming we know how to do t and lay the program out 
in detail When we get done, we should have all our classes 
and methods identified and how they interact with each other. 

Figure 14 shows how ImagePan will lx* implemented. The 
main points of interest here are that the MyOpenPict method is 
called from HandleEvenl, and the use of operations A 
(CreatePart) and B (GetStorageUnit) where SciectPart is 
instantiated and the file name is retrieved from persistent storage. 


ImagePaht 

Build the project using PuriMakcr or the procedure given in 
Appendix B. Use ImagePart and KSS as the class and module 
identifiers, respectively, 

First we need to modify the header declarations. Add die 
following lines to the end of the ImagePart *h file. Pur these 
lines at the end of the methods declaration: 

// * I Iscr methods « 

void MyOpenPict(Environment *ev); 

Put this line in the private variable declarations: 

Str255 fTextData; 
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Figure 14. Flowchart for JmugePari, 

Figure 15 shows that the GetFileName method is called 
from the IniLPariFromStorage metlxxL 


Now we come to displaying a message on the screen. 
Add the following lines to the end of the Initialize method 

tftrepy{(char*}fTextData * "Hello World!"): 
c2pstr((char 4 )fTextData): 

The screen is redrawn in response to update events during 
idling. The code for doing this is located in the 
FrameDrawView method* 

In the FrameDrawView method, remove the code after 

frameWidi.il - {** TrameRgn) .rgnBBox*right • 

(* * f rameRgn). rgjs BBux .left! 


and replace it widi the following: 

DDSTiOng rfRef; 

{ 

CUsingLlbraryResources fill 
PeraState penState: 
GetPenStateC&penState); 
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PeriNurmai () ; 

SbowPent); 

Reel ret: 
short x, y; 

ret = (’’“frameRgn). rgnBBox; 

: sFrameKoundRect (&rct. hQ> 40): 
x ~ (ret.right 1 ret.left 

::StringWidth(fTextData)) / 2; 
y - (ret.bottom - reL.top 12) / 2: 
iiHovelDtx, y): 

:;DrawSt rtrag(fTextData); 
SerPenSlutel&penState); 

I 

frameShape >Reiease(ev}; 


Next, we need to implement Our menu item. The following 
changes are necessary in order to lx* able to chouse the Open 
Piet File item of the Image menu. 

Open the ImagePartOt'herResources-rsre file with 
ResEdil and add the linage menu (resource item 5000) with a 
single item named Open Piet File (see Figure 10). 

Add the following items to the ImagePartDef.h file. 

// Hie ‘Picture" menu's resource and menu ID; 

ffdefine kTinagePartMenuID 5000 

// Menu item ID* 

^define kOpenPictlxaro 1 

if Menu command numbe rs Must start ;it 20000 

^define kOpenPIclCmd 20000 

If SdcctParr items 
jttaflnc kSelectPartKind 

"Apple;Kind;SelectPart" 

// Storage type 

const ODFroper;yName kPropSelectPartKame * 

"Sc 1 ectPart: Property: Name" ; 

kSclectPartKind is an identifier for Select Pa it so that i( 
can he found and used. 

Acki the following items to the end of the Initialize 
method. Re sure gMenuBar * session > 
GetWindowState(ev) - > CopyBaseMenuBar(ev) is 
called before this code, 

I 

CUsin^LibrdryRcsourc^s til; 
f He tin = : :GclHc?uutkImageFartHenuTI>) : 
if (fMenu) 

:;DetachResoUcce((Handle)FMunu): 

I 

ir (ffHenu) 

DebugStr("\pGetMenu failed"): 
gHenuBar->AddMenuI.tfSt {ev, klmageParf Kenult), £Merau, 
fSelf): 

I 

CHsingLibraryResources fi 1; 
gMonuBar ■ >RegisterCommand (ev * kOpenPic tCmd* 
klmagePartMenuTD, kOpenPfctltem); 


Add to the HandleMenuEvent method: 

case kOpenPIctCmd: 

MyOpenPicl(ev); 
break; 

Now we add the MyOpenPiet method. It will have the 
following code: 
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void IinagePart; iMyOpenPict (Environment ‘ev) 
t 

OOPart "aelectFile; 

ODStoragellni t *su: 

ODStoragaUnit l pbSU: 

Str255 air: 
unsigned long size; 

su - fSeif->GetStorageUniL(ev); 

selectFile - su->€eiDruft(ev)->CreateParr{ev. 

kSelectPartKirad. kODNULL); 
if (eelertFile != kODNULL) 

t 

pbStl - selectFileOGetStorfl^eHnil (ev): 
pbSLI H'ocus(ev. kPropSfiloclPartName ♦ 

kOBPosSame, kODFSOSir, 1, kOOPosFirstSib): 
size - pb£U->GetStzelev); 
StorageUnitGotValuetpbSU. ev, size, str); 
strepy((char 4 )fTextData, (char # )str ); 
c2pntr((char*)fTextData): 

// Notify program itt.ii window Is invalid 
I 

else 

DebugStr("\pCannoi Create Select Part"); 
selectFile)Releasc(ev ); 

I 


Now we come to the matter or creating and disposing of a 
part and accessing its persistent data. To create a new pail you 
must first get a reference pointer to your storage unit. Ihe new 
part is instantiated and initialized hy calling die GerDraft 
method of the storage unit which in turn calls the CreatePart 
method. These calls return a reference pointer Lo the part. 

An external part’s persistent data is accessed by getting an 
object reference to it by calling the external part's 
Ge LStorageUnit method. The storage unit’s focus method is 
then used to pinpoint die desired data. Get Size is used when 
the size of the data is unknown. Finally, the data is retrieved 
by calling the Open Doc GetStorageUnit method. 

Create a new piojeei named SelectPait using PartMaker Use 
die identifiers SefectPart and ESS. Name the folder Select Pari. 

First, the header declaration. Add the following line to 
SelectPart *h. 

void GetFileNmne( Environment ^ev); 

Now we set up the persistent variable. Add the following 
three lines to the end of ihe Initialize method. 

ODStora^ellnit ’storageHaiti 
storafcelinir * fSelf -HJetStorageUttitCev} ; 
storage.Un I r - AddProperty 

(ev, kP ropSelectPar tName)-> 

AddValue(ev, kODTSOStr): 


The Add Property () - >Add Value () complex reserves 
space in the parts storage unit for a kOOXSOStr of the 
kPropSe I ecLName type. kPropSelec tNarae is defined 
arbitrarily by the programmer in die SelectDef .h file as: 

const ODPropert /Name kPropSelectName ~ 

"Select:Property;Name"; 


where Select is the part identifier and Property is an Apple 
lerm which is defined Ixdow. The term Name was selected by 
the programmer. 
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It is time for a few more definitions. The term "Property" 
is defined in the OpenDoc Class Reference as an element of a 
storage unit. It defines a kind of information, such as a name 
or a piece of data, and contains one or more values (data 
streams containing one or more bytes). In the case given 
above, the term “Property” is used as follows: 

Part identifier:Property:User 

or Apple defined selected name of identifier. 


Note how the term kPropS elect Name is put together 
based upon its definition. 

It is strongly recommended that the programmer use die 
above conventions, as they facilitate identifications of tokens 
and reduce the chances of creating duplicate names. 

Another term which it would be helpful to learn at this 
time is kQDISOStr, This is a null-terminated string made up 
of 7-bit ascii characters. Note that it is a subset of a C string. 

Observe that it is crucial that the proper Cl Labs ISOString 
prefix be used for all ISOStrings (such as kSelectPartKind). 

This completes the changes to the My Common I nit Part 
method. Next, we need to deal with the method 
GetFileName; add the following line to the ends of the 
InitPart and InitPartFromStorage methods. 

this->GetFi1oNarae(ev): 

Add the code for the Ge tFl.l eName method to the end of 
the SelectPart.cp file. 

void Selectman ”GetFiieHaiac(Envi ronment* ev) 

t 

Point where; 

SFTypeList typcLifit; 

SFfteply reply; 

int vRefUum: 

unsigned long Ion; 

Str253 rtr; 

ODStorageUnlt atorageUnit; 

atorageUnit “ fSelf >GetStorageUnit(evl: 

where.h = 40; 
whetc.v * 40; 
l 

CUsingLlbraryResourGes fil; 

\ 

; :SetCursor(SQDQDGlobals.arrow): 

; :SFGetFile(where, 0L. 0L. typeList . QL. 
imply); 

J 

I 

if {(reply.good = true) && (fttirty !- kODFalse)) 

I 

vRefNum = reply.vRefNura: 
p2cstr (reply . fNatno); 

strepy((char 4 )fitr* (const char*)reply.fName); 

ten = strlent(char*]str); 

storagellnit ->Focus (evkPropSelectPartNanse. 

kODPosSatne, kODISGStr. 1, kODPocFirstSib): 
StorageUniLSetValue(storageUnii* cv, lan, 

(ODValue)frsir); 

ODSUForceFocus(ev * storage Unit . 

kFropSeiectPartName. kOMSOStr): 

I 

* 

Now for the matter of storing persistent data. There are 
two steps in storing persistent data. First, space must be 
allocated. As shown above in the code for the Initialize 


Using OprnDoc Wmi Object Flow System (GFS) 


method, this is done by getting an object reference to the 
pan's storage unit and then calling its AddProperty method 
with name and size information. 

An example of the second step is shown in the code for 
GetFilename. First, you get an object reference to the 
storage unit and focus on it by providing name, type and 
position information for the variable. Next, the OpenDoc 
method SetTheValue is called and the value is forced into 
Storage by calling the ODSUForceFocus method. 

Where To Go From Here 

We had originally intended to show how global parameters 
could be passed from the ImagePart to the SelectPart. 
Specifically, we wanted to pass in the information that only the 
names of PICT files were to appear in the dialog box, 
Unfortunately, we ran out of Lime and were unable to do this. 
This should be a good exercise for the reader. 

The reader has no doubt noticed that we put a comment 
into the KyGpenFict method saying, in effect, “Let OpenDoc 
know the screen needs lo be refreshed” Implementing this 
instruction would result in an immediate screen refresh. As it 
stands, you must do something like put a Microsoft Word 
screen on top of the window and then switch hack to 
OpenDoc to get the screen refreshed 

The next logical thing to do with ImagePart is to make it a 
container for other parts. 

Finally, figure out how to deallocate the persistent memory 
used to store the file name. 

Further Reading 

The serious acolyte will want to read the following articles. 

Alike, J.P. T “Learning to Love SOM," MacTecb Magazine. 11:1 
0 995) 12-17. 

Alike, J,R, and J. Mattson. “Opening Up OpenDoc,” MacTecb 
Magazine , 11:1 (1995) 52-65. 

Apple Computer, “OpenDoc Cookbook for the Macintosh,” 
OpenDoc Developer CD #3 and Apple Developer CDs. 
Apple Computer, "OpenDoc Programmer's Guide for the Mac 
OS,” OpenDoc Developer CD #3 and Apple Developer CDs, 
CampagnonL F.K., “IBM's System Object Model,” Dr Dobbs 
Journal ("Special Report”), Winter 1994/1995, 24-29, 
Curhow, D., and E. Dystra-Erickson, “The OpenDoc User 
Experience," Develop 22 0995) 83-93- 
Goldstein, N. t and J. Alger, Developing Object-Oriented Software 
for the Macintosh, Addison Wesley, 1992. 

Kenner, G. T and D. Kenner, Object Flow System (OFS) for Visual 
C++, unpublished manuscript, 1995. (Request via email). 
Kenner, G., and D. Kenner, “Outlining the Art Class Tools 
Menu/ MacTecb Magazine, 9:12 (1993) 56-63* 

Uoyd T J,, “Tire OpenDoc Development Framework/ MacTecb 
Magazine, 11:11 (1995) 35-57. 

Piersol, K. T ‘ Building an OpenDoc Pan Handler/ Develop, 19 
(1994) 6-16. Though outdated, this is still the best 
introductory article on the subject, 
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Plersol, K,, “Gcuing Started with OpenDoc Graphics,* Develop, 
21 (1995) 5-22. 

Rush, "OpenDoc/ Dr. Dobb's Journal (“Special Report”), 
Winter 1994/1995, 30-35. 

APPCNU1X A: 

OFS Programming at the Flow Diagram Level 

An example of the topmost chart of the flow diagram level is 
shown in Figure Ai, The symbols contain shortened names of 
subprojects. Other names for subprojects are subjects or 
program components, Each sub project is linked to a 
subchart containing names of component subprojects or a flow 
diagram showing program execution flow r . Hie flow diagram is 
the lowest level. 
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Figure A3 Object level notation: common operations. 
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Figure A1 Example of the* topmost chart of flow diagram levd. 


Figure A4 shows examples of the numbering system used to 
keep track of the order in which operations occur. Capitalized 
roman numerals are not used because they take up too much 
space. The hierarchy is: capitalized arabic letters, arabic 
numbers, lowercase amine letters, lowercase roman numerals, 
The sequence is repeated if more sublevels are needed. 


There arc two types of flow-charting, object (low and 
method flow. Figure A2 shows tile bare notation of object flow' 
diagramming. 
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PStringCopy 
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r :myR*f 




Existing objH>t 


Method call 


Figure A2 . Object level notation: objects and methods. 


The object flow level is based on the use of a hexagonal 
symbol containing the name of the class of which the object is an 
instance, and the name of the object reference, if used. If the 
symbol has a plain border then the object was instantiated 
somewhere on the page which contains the symbol 1! the symbol 
has a heavy Ixjrder, then the object was instantiated elsewhere and 
is ix-ing used on die present page, Ihe bottom part of Figure A2 
shows how a method call is symbolized* Note that them are no 
directional arrows. These were deleted to simplify' diagramming. 

Figure A3 shows how to execute some common 
operations at the object flow level. Several examples of how to 
do this are given in the main text of the article. 


Figure A4 . Object level notation, hierarchy. 

In our system, method flow-charting is the lowest level 
before coding begins (Figure A5). At this level, operations are 
shown in sequence. The screen is divided into two unequal 
parts. The left-most quarter holds the execution start points 
and the emblems containing class names and object references. 
The right most three-quarters contains the programming 
operations* A comments box is usually present at the bottom. 
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Figure A 5. Method lew! flow-charting example. 
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Got Software for Sale? 


No Advertising Budget? 


Try listing your product in MacTech Magazine’s Mail Order Store 
Classified Advertising at ^cost effective rate! 

Hot 







For more information, call, fax or e-mail: 
Voice: 805/494-9797 • Fax: 805/494-9798 
Internet: marketing@xplain.com 
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Figure A6 shows the symbolization used in method flow¬ 
charting, Most of these are self explanatory. 
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Figure A6. Symbols used by OFS for method level flow-charting. 


Appendix B; Converting thf SamplePart Template 

This is how to create a project folder named ImagePa rt. It 
requires about Lhirty minutes to do a conversion. Make copies 
of the SamplePart and Build Support folders onto your 
liard drive. The Build Support folder does not need any 
changes. Using a good editor such as BBEdit™ or BBEditLite™ 
(RareBones Software), find and replace all instances of the 
following words in the files of the SamplePart folder 


SampleCode Change to your company identifier. 

In our case, this is KSS 

SamplePart Change to the new class name. In 

this case, Image Part Image or 
any other name will also work as 
long as it is distinctive* 

SampleCollections Change to ImageColIections. 

Case is not important. 

Close the editor and go to the SamplePart folder. Change 
all instances of the word Sample to Image in Lhe names of the 
folders and files. For instance, change the name of the main 
folder from SamplePart (C++) to ImagePart (0+) 

Open the resource fde ImagePartOtherResources.rsrc 
and remove the 'vers 1 resource, it causes a conflict when 
the project resource is rebuilt. 

Using SARez (from Pascal compiler folder) or Rez, 
recompile the project resource. The source file is 
ImagePart ,r in the source folder and the target file is 
ImagePart.PPG.rsrc located in the Object: PPG: directory. 
Use replace to create a new ImagePart * PPG. rsrc fde. The 
pathway to the headers fdes is OpenDoc:Interfaces:Rez:. 
Load all the files* 

Open the ImagePart project file and replace all instances 
of sample files with the renamed Image files. 

Build the project. ^ 
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OpenDoc Developer Release 4 

IMPORTANT - READ CAREFULLY BEFORE USING THE SOFTWARE 


Apple Computer, Inc. Software License 

PLEASE READ THIS SOFTWARE LICENSE AGREEMENT 
(“LICENSE") CAREFULLY BEFORE USING THE SOFTWARE. 
BY USING THE SOFTWARE, YOU ARE AGREEING TO BE 
BOUND BY THE TERMS OF THIS LICENSE. IF YOU DO NOT 
AGREE TO THE TERMS OF THIS LICENSE, PROMPTLY 
RETURN THE SOFTWARE TO THE PLACE WHERE YOU 
OBTAINED IT FOR A REFUND. 


1. License. The software accompanying this License (the 
“Apple Software") is licensed, not sold, to you by Apple 
Computer, Inc. (“Apple"). Apple and/or Apple's licensor(s) 
retain title to the Apple Software. The Apple Software 
accompanying this License and any copies which this 
License authorizes you to make are subject to this License. 

2. Permitted Uses and Restrictions. You may use and install 
the Apple Software on as many of your Apple-labeled or 
Apple-licensed computers (“MacOS computers") as are 
reasonably necessary to develop OpenOoc-compatible parts, 
containers, and applications designed to operate in 
combination with MacOS computers (“Applications"). You 
may not use the Apple Software for any other purpose, 
including but not limited to, in the development of, or lor 
incorporation into, operating system software. In 
connection with the development of your Applications, you 
may also use, incorporate into your own Applications, 
compile, copy and distribute (in object code form only) as 
part of your Applications, the Apple Software identified in the 
Licensing Information folder located on the top level of this 
CD, provided you reproduce on each copy the copyright 
information contained on the original copy of the Apple 
Software. Except as expressly permitted in this License, you 
may not decompile, reverse engineer, disassemble, modify, 
rent, lease, loan, sublicense, distribute or create derivative 
works based upon the Apple Software in whole or part. Your 
rights under this License will terminate automatically without 
notice from Apple if you fail to comply with any term(s) of 
this License. 

3. Disclaimer Of Warranty. Some of the Apple Software may 
be designated as alpha, beta, development, pre-release, 
untested, or not fully tested versions of the Apple Software. 
Such Apple Software may contain errors that could cause 
failures or loss of data, and may be incomplete or contain 
inaccuracies. You expressly acknowledge and agree that use 
of the Apple Software is at your sole risk. The Apple 
Software is provided "AS IS” and without warranty of any 
kind and Apple and Apple's licensor(s) (for the purposes of 
Sections 3 and 4, Apple and Apple's licensor(s) shall be 
collectively referred to as "Apple") EXPRESSLY DISCLAIM 
ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING, 
BUT NOT LIMITED TO. THE IMPLIED WARRANTIES OF 
MERCHANTABILITY AND FITNESS FOR A PARTICULAR 
PURPOSE. APPLE DOES NOT WARRANT THAT THE 
FUNCTIONS CONTAINED IN THE APPLE SOFTWARE WILL 
MEET YOUR REQUIREMENTS, OR THAT THE OPERATION 
OF THE APPLE SOFTWARE WILL BE UNINTERRUPTED OR 
ERROR-FREE, OR THAT DEFECTS IN THE APPLE 
SOFTWARE WILL BE CORRECTED. FURTHERMORE, APPLE 
DOES NOT WARRANT OR MAKE ANY REPRESENTATIONS 
REGARDING THE USE OR THE RESULTS OF THE USE OF 
THE APPLE SOFTWARE OR IN TERMS OF THEIR 
CORRECTNESS, ACCURACY. RELIABILITY, OR OTHERWISE. 
NO ORAL OR WRITTEN INFORMATION OR ADVICE GIVEN 


BY APPLE OR AN APPLE AUTHORIZED REPRESENTATIVE 
SHALL CREATE A WARRANTY OR IN ANY WAY INCREASE 
THE SCOPE OF THIS WARRANTY. SHOULD THE APPLE 
SOFTWARE PROVE DEFECTIVE, YOU (AND NOT APPLE OR 
AN APPLE AUTHORIZED REPRESENTATIVE) ASSUME THE 
ENTIRE COST OF ALL NECESSARY SERVICING, REPAIR OR 
CORRECTION. THE LICENSE FEES FOR THE APPLE 
SOFTWARE REFLECT THIS ALLOCATION OF RISK. SOME 
JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF 
IMPLIED WARRANTIES, SO THE ABOVE EXCLUSION MAY 
NOT APPLY TO YOU, 


4. Limitation Of Liability. UNDER NO CIRCUMSTANCES 
INCLUDING NEGLIGENCE, SHALL APPLE BE LIABLE FOR 
ANY INCIDENTAL, SPECIAL OR CONSEQUENTIAL 
DAMAGES THAT RESULT FROM THE USE OR INABILITY TO 
USE THE APPLE SOFTWARE, EVEN IF APPLE OR AN APPLE 
AUTHORIZED REPRESENTATIVE HAS BEEN ADVISED OF 
THE POSSIBILITY OF SUCH DAMAGES, SOME 
JURISDICTIONS DO NOTALLOW THE LIMITATION OR 
EXCLUSION OF LIABILITY FOR INCIDENTAL OR 
CONSEQUENTIAL DAMAGES SO THIS LIMITATION MAY 
NOT APPLY TO YOU. 

In no event shall Apple's total liability to you for all damages, 
losses, and causes of action (whether in contract, tort 
(including negligence) or otherwise) exceed the amount paid 
for this License. 

5. Export Law Assurances. You agree that the Apple 
Software will not be exported outside the United States 
except as authorized by United Slates law. You also agree 
that Apple Software that has been rightfully obtained outside 
of the United States shall not he re-exported except as 
authorized by the laws of the United States and of the 
jurisdiction in which the Apple Software was obtained. 

6. Government End Users. If the Apple Software is supplied 
to the Department of Defense (“DoD") of the United States 
Government, the Apple Software is classified as 
"Commercial Computer Software” and the DoD only acquires 
"restricted rights" as defined in Clause 252.227-7013(c)(1) 
of DFARS. If the Apple Software is supplied to any other unit 
of the United States Government, the Government’s rights 
are as defined in Clause 52.227-19(c)(2) of FAR or, in the 
case of NASA, as defined in Clause 18-52.227-86(d) of the 
NASA Supplement to the FAR. 

7. Controlling Law and Severability. This License shall be 
governed by the laws of the United States and the State of 
California. If for any reason a court of competent jurisdiction 
finds any provision, or portion thereof, to be unenforceable, 
the remainder of this License shall continue in full force and 
effect. 

8. Complete Agreement. This License constitutes the entire 
agreement between the parties with respect to the use of the 
Apple Software and supersedes all prior or 
contemporaneous understandings regarding such subject 
matter. No amendment to or modification of this License 
will be binding unless in writing and signed by Apple, 
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By Dave Mark 


A monthly column of 
assorted news, interviews, 
and technical information 
from Metrowerks. 


In last month’s issue, we introduced a 
brand new column with Rule in the way 
of explanation. Here’s the skinny. At 
Neil's persistent urging, the folks at 
Metrowerks asked me to put together a 
regular monthly column, but with no 
particular agenda. For example, last 
month's column was a Java interview 
with Greg Gala nos, Metrowerks' 
President and CEO. This month, well 
go through a pile of Metrowerks tech 
support questions and answers. Got 
any ideas? Any interviews you’d like to 
see? As always, your feedback is most 
welcome. Check out page 2 of the 
magazine for contact information. 

The questions were provided by Stephen 
Chong, Khurrum Queresbi, and the folks 
at Metrowerks tech support, / did a little 
hit of editing just to clean up the 
questions hut / tried to keep with the 
spirit of the original question. Since not 
everyone wants their name up in lights r / 
didn 7 include names with the questions. 

Top Ten Tech Support Questions 

Q: My program makes extensive use of 
SIOUX for console i/a, and I 
frequently generate more than 32K 
worth of output in the console 
window. Pve noticed that when I 
scroll down to the bottom of my 
console window, I occasionally end 
up with garbage in the window and 
sometimes the window stops 
scrolling. Any ideas? 


At Our SIOUX output window can only handle 32k of output at 
a time, and after you send it more than that, results are 
unpredictable. The solution is to either redirect stdout to 
a file (via the ccomroandO function/dialog in console.h) 
or change the printfs to f printfs arid write to a file. 

Q: How can 1 use the debugger for debugging MPW tools and 
how can 1 specify command-line arguments when 1 am 
debugging? 

A; Currently, our debugger doesn’t support debugging MPW 
ttx)Ls. One option is to build your tool as an application that 
uses the ccommand () function to take its command-line 
arguments and I/O redirection. Once it is debugged, you 
would change the project type back to MPW tool, swap 
ANSI libraries, and remove the ccommand call. Another 
option is to purchase Steve Jasik s The Debugger, which can 
debug 68K MPW tools, and possibly PPG ones, 

Q: In the following code snippet, the scope of the variable i 
inside the for-loop doesn't conform to the ARM when I 
compile using the Code Warrior C++ compiler. Why is that? 

void scopeQfVars (1 

I 

long a - 0; 

if (a) 

for (long i “ 0: i < 12; ++i) 
a = 1; 

else 

for (long i = 0; 1 < 12; ++i) 
a = i + 1? 

I 


A: The scope of the index is just within the fordoop; this agrees 
with the draft ANSI Standard for C++ which is what 
CodeWarrior follows. If you instead want to force ARM 
conformance, which allows the index to live outside the for- 
loop, you can do this hv checking the FIRM Conformance 
checkbox in the C/C++ Language Preferences panel. 

Q: 1 have two source code files l am linking together. One is 
written in G and one in Pascal. Here’s the Pascal source 
code, from source file Fog . p: 

unit Foo; 
interface 

var 

nyGlobalVariable ; Integer; 
implementation 
end. 
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Here’s the C source code: 

extern short myGloba1Variable; 

void main(void) 

( 

myG1ob a1V a ria h1; 

I 

When I compile and link these files using CodeWamor I get 
a linker error complaining that rayGlobalVariable 
referenced from main is undefined. What gives? 

A: You will need to do either (but not both) of the following to 
make your code link: 

* In the Pascal source, enclose die variable declaration 
with the compiler directive [$J+] and f $J- ), The $J 
directive controls the case conversion of global 
identifiers when building object files. 

or 

• Use all uppercase in Lhe variable name in your C source 
code. 

Q: I just upgraded to CW7 and Pm having problems getting a 
CW6 Pascal 68K project to link under CW7. When 1 
recompile my code, I got the following linker errors: 

Link Error : StrOp.c f memchr r referenced 
from T _PQSITION ' is undefined. 

Link Error : MWP.Stub. 1 ib; referenced 

from *NUM2STR 1 is undefined. 

Link Error : MWP ,Stub.lib: "STR2EEC 1 referenced 
from 1 STRSWOti 1 is undefined, 

A; Under CW7, the IDE is now integrated, allowing Pascal and 
Cm use the same set of ANSI C libraries. You'll need to 
make sure these libraries have been added to your project, 
To find out all the libraries needed for a typical 68k project 
in CW7, you might want to create a new r project using the 
MacOS 68k Pascal project stationery, then compare 
your new project to your old project. 

Q: In CW6, f used the libraries P / ANS . 6 8K, lib and 
SetLib . Lib (A5}. What are the CW7 equivalents? 

A: Neither of these libraries are needed under CW7, 

Q: 1 have a simple ANSI C console-based program T wrote on 
the Mac and that 1 am trying to get working under Windows 
'95, The program works just fine under MacOS but I can’t 
get it to build using the Win32/x86 environment, I am 
using the Win32s libraries as used in the CW7 Win32/x86 
tutorial bur l can't get my project to link sucessfully. 

A: Inside the (Project Stationery) folder is a folder 
called Additional Project Stationery. Drag die 
Win32 Console application stationery' from there Into the 
(Project Stationery) folder. Next, create a new 


project using the Win32 Console app stationery. The binary 
created from there should run without problems under 
Windows95, I just tried it with Hello World and it ran 
fine on my Win95 machine. 

Q: Is there a way to “Import” Lhe Lem plate 1 made in version 1 
of Constructor into version 2 of Constructor? 

A: Unfortunately, Constructor 1 and 2 are completely different 
programs (literally), and they use a differeni mechanism for 
custom typ es - flight now it isn’t possible to import 1.0.1 
templates into 2.0. 

Q: How can 1 get a SlOUX-based program to quit without 
pausing when the program ends or without waiting for the 
user to select Quit from the File menu? 

A: Try this: ^include the file <SIGUX H h>, then add the 
following code at the beginning of main (): 

SlOUXSettinga. autocloseonquit = true; 

SlDUXSettings.asktasaveonclose = false; 

Q: Tm trying to debug a code resource. However, after 1 set a 
breakpoint at the beginning of the resource and then run 
the application that calls this resource, 1 never drop into the 
debugger. What’s happening? 

A: Under CW7, you can debug only 68K code resources. 
Debugging PPG code resources will be available in CW8 
(contact tech support to request a beta). If you are 
debugging a code resource under CW7, carefully follow Lhe 
instructions in the Debugger manual on debugging code 
resources. Here is the basic procedure: 

After creating the . SYM file for the code resource, change 
its name (to anything). Double-dick on it, and then (since 
the name no longer corresponds Lo any executable), the 
debugger will ask you for the name of the executable to 
Itxik at. Give it the name of the executable you’ve created 
that contains tills resource. You can now set breakpoints. 
Next, leaving the , SYM window open, double-click on the 
application itself and control should be transferred to the 
Debugger. Let us know if this sequence of steps doesn’t 
work. (In that case it might be necessary for us to look ai a 
copy of the project in order to diagnose the problem.) 
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PROGRAMMER'S 

CHALLENGE 


By Bob Boonstra t Westford, Massachusetts 



Intersecting Rectangles 


The Challenge this month is to write a routine that will accept 
a list of rectangles and calculate a result based on the 
intersections of Lhosc rectangles. Specifically, your code will 
return a list of non-overlapping rectangles that contain all 
points enclosed by an odd (or even) number of the input 
rectangles. The prototype for the code you should write Is: 


void Ket t angl el tiler sect ions ( 
const Rect inputKeets[]* 
const long aumEtectsln, 
Rect outputReets |j. 
tong *numRectsOi]t, 
connt Boolean oddParity 


t list if input rectangles 7 
t number of inpuiRecis 7 
t prcalloeatcd storage for output 7 
r rujuIkt of ouipulRccLi returned 7 
/* Stcc text for explanation 7 


The parameter odd Parity indicates whether you are to 
return rectangles containing points enclosed by an odd 
number of the numRectsIn inputRecta rectangles 
(oddParity=tnie) or by an even (nonzero) number of 
rectangles (oddParity"£&lse), Sufficient storage for the 
output will be preallocated for you and pointed to by 
outputReets, 

As an example, if you were given these inputRects; 

10*10,20,301, 15,15.20.301 

and oddParity were inie, you might return the following 
list of outputReet s: 

{ 0 , 10 , 5 , 151 * 10 * 15 * 5 , 301 . 15 . 10 . 15,201 

it would also lie correct to return a result that combined 
lire first of these rectangles with either of the other two. If 
oddParity were false, you would return the following list 
for the example input: 

15 , 15 * 20 . 30 ] 


The outputReets must be non-empty and non- 
overlapping, In the example, it would be incorrect to return the 
following for the odd parity case: 

10 , 10 . 5 . 30 } 10 . 10 . 20.151 

The outputReets you generate must also be maximal, in 
the sense that each edge of each of the outputReets should 
pass through a vertex of one of the in put Rects. That is, for 
example, f don’t want you to return a lxl rectangle 
representing each point enclosed in the desired number of 
inputRects* Before returning, set *numRectsOut to 
indicate the number of outputReets you generated. 

If you need auxiliary storage, you may allocate any 
reasonable amount within your code using toolbox routines or 
malice, but you must deallocate that storage l>efore returning. 
(No memory leaks! — Til be calling your code many times.) 

This native PowerPC Challenge will be scored using the 
latest Metrowerks compiler, with the winner determined by 
execution time. If you have any questions, or would like some 
test data for your code, please send me e-mail at one of the 
Programmer's Challenge addresses, or directly to 
bob_booastra©mactech.com. Test data will also be sent to the 
Programmer's Challenge mailing list, which you can join by 
sending a message to autoshare@mactech.com with the 
SUBJECT line “sub challenge YourName*, substituting your real 
name for YourName. 

Two Months A<;o Winner 

Eight of the 13 solutions submitted for the Find Again And Again 
Challenge worked correctly. Congratulations to Gustav Larsson 
(Mountain View, CA) for submitting an entry that was significantly 


Here'S how it works: Fach month we present a new 
programming challenge, First, wrire some code (hat solves I he 
challenge. Second, optimize your code (a lot). Then, submit your solution to 
MacTeeh magazine, We choose a winner based on code correctness, speed, 
size, and elegance <tn dial order of importance} as well as the submission 
dare In rhe event of multiple equally desirable solutions, we ll choose one 
winner (with honorable mention, bui no prize, given to tire runner up). The 
prize for each month’s best solution is a Si00 credit in die MacTech Mail 
Order Store and a limited-edition, “The Winner! MacTech Programmers 
Challenge" T-shin (not available in stores anywhere). 

Unless staled udrerwise in tlie problem statement, the following rules apply: 
All solutions must lx? in ANSI compatible G Use only [>une C code. We disqualify 
entries with any assembly in them (except Tor drallenges specifically staring 
otherwise) You may call any Madniosh Toofcox routine (eg, it doesn’t matter if 
you use NewPtr instead of rmlloc). We test entries with compiler options set to 
disable FPU use (for 680x0 code) and to enable all available speed optimizations. 
'Hie compiler to be used and rbe target instruction set (680x0 or PowerPC) will be 


stated in the problem. limit your code to 60 diameters per line; 
tills helps with e-mail gateways and page layout. 

We publish the solution and winners for each month's Programmer's 
Challenge two months later. All submissions must bo received by the 10th 
day of the month printed on the front cover of this issue 

You can get a head sum. on die challenge by reading the online version. 
We post it to the online services at the same time that we post source code. 
We make every effort to have it online no later than when the magazines are 
mailed, but we re unable to guarantee that it will be? online by any given date. 

Mark solutions “Attn: Programmer's Challenge Solution" and send it by 
e-mail to one of tire Programmer's Challenge addresses in (he "How to 
Communicate With Us* section on page 2 of this issue. Include the solution, 
all related files, and ytttir contact info. 

MacTech Magazine reserves the right to publish any solution entered in 
the Programmer's Challenge. Authors grant MacTech Magazine the exclusive 
right to publish entries without limitation upon submission of each entry. 
Authors retain copyrights tor the code 
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faster than the others, I lie problem was to write a text search 
engine optimized to operate repeatedly on the same block of text, 
A variety of optimization techniques were represented in the 
solutions, a couple of which are highlighted in the table of results 
below. Several people optimized for the case where the same 
word was repeatedly searched for. Some of my tests included this 
case, and those results are in the columns headed “repeat/ The 
"random” columns shows results for tests that searched for random 
occurrences of random words. Each of the tests were am under 
conditions where only 64KB of auxiliary storage was available, 
and where much more memory was available. These conditions 
were weighted 20% and 80% respectively in calculating the total 
Lime, since the problem statement promised that ample memory 
would usually be provided. You can see that Gustav's solution 
performed reasonably well when memory 1 was scarce, and very 
well when memory was plentiful. 

Gustav’s solution hashes as many words of the input text 
as possible in the initialization routine. He uses die Boyer- 
Moore-Horsp<x>l algorithm to find words in any text that was 
not parsed during initialization. Other features of the approach 
are described in the well-commented code. 

Here are the times and code sizes for entries that passed 
by tests. Numbers in parentheses after a person's name 
indicate that person's cumulative point total for all previous 
Challenges, not including this one. 

64K Memory »64K Memory' code 


Cet Ahead 



Meet Charlie. Charlie likes to program. But Charlie hates boring, repetitive code, so 
he created Open Dialog"' Open Dialog is "everything the Dialog Manager should've 
been/' Use Charlie's head far dialogs and save your head (and your hair) for real 
problems, A set of libraries that replace the Dialog Manager, Open Dialog will 



* Simplify creation af multi-panel 
items, such as preference dialogs. 

* Relieve you of silly chores, like 
managing radio buttons. 

* Provide you with "ntHesource" 
dialogs for alerts & progress bars. 


Easily integrate into existing cade. 
Cast only $259 (source code license 
available). 

Keep you from going bald. (Charlie 
lost his hair before Open Dialog ) 


FGM 1(u, • 703.478.9881 • http://www.fgm,com * email: opnttlg4Z@fgm.cojn 


Name 

repeat random 

repeat random 

lime 

size 

Gustav Larsson (67) 

1814 

3773 

62 

111 

1255 

3584 

Tom Saxton 

46 

16400 

197 

459 

3814 

2000 

Xan Gregg (81) 

27 

2907 

1316 

2835 

3907 

1664 

Kevin Cutts (46) 

IT® 

3234 

1760 

2809 

4654 

1600 

Joseph Ku 

8856 

14570 

121 

509 

5189 

1584 

David Cary 

60 

22665 

499 

1000 

“r 

2124 

Eric f.engyei (40) 

34 

10221 

29 

4697 

5831 

1188 

Ernst Munter (110) 

2036 

2053 

2287 

4603 

6330 

2976 


There are three ways to earn points: (1) scoring in the top 

5 of any Challenge, (2) being the First person to find a bug in a 
published winning solution or, (3) being the first person to 
suggest a Challenge that I use. The points you can win are: 

1st place..20 points 5th place.2 points 

2nd place..10 points finding bug .... .2 points 


Top Contestants of All time 


3rd place.7 points .suggesting Challenge .2 points 

4th place.4 points 


Here are the Top Contestants for the Programmer’s Challenges 

to date, including everyone who has accumulated more than 20 Here is Gustav's winning solution: 

points. The numbers below include points awarded for this 

month's entrants. Find Again and Again 


Rank 

Name Points 

Rank Name Points 

1 . 

[Name deleted] 

176 

a. 

Mallett, Jeff 

44 

2. 

Munter, Ernst 

110 

12. 

Ka spartan, Ha Mi 

42 

3- 

Gregg, Xan 

88 

13. 

Vineyard, Jeremy 

42 

4. 

Larsson, Gustav 

87 

14. 

Lengyel, Eric 

40 

5. 

Karsh, Bill 

80 

15. 

Darrah, Dave 

31 

6. 

Stenger, Allen 

65 

16. 

Landry, Larry 

29 

7. 

Riba, Stepan 

51 

17. 

Elwertowski, Tom 

24 

8. 

Cutts, Kevin 

50 

18. 

Lee, Johnny 

22 

9- 

Goebel, James 

49 

19. 

Noll, Robert 

22 

10. 

Ncpsund, Ronald 

47 





Copyright © 1995 Gustav Larsson 


^define ALPHABETIZE 2bb 
//define ALL0C_SIZE(n) (Cti+3) & -4L) t next multiple of 4 7 
//define HASH_BUCKETS 1024 /* must be power of 1 7 

//define HASH.MASK (HASOUCKETS - 1) 

//define N0_NULL CHAR 1 A* 

^define NULL 0 


Qinstant-5 St Types 


typedef unsigned char tiehar; 
typedef unsigned short usheri; 
typedef unsigned long along,: 

typedef struct Word Word: 

typedef struct Occurrence Occurrence: 

typedef struct Private Private; 
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(occur)->p.pos4[index] -pos; 


r 

A block of occurrence positions, We pack in as many occurrences as possible into 
a Single block, fmm 3 lo 6 depending on tcxiLcngth, 


The first entry in the block is always used- The remaining entries are in use if they 
are n<H zero. These facts arc used several places to simplify the code. 

7 


ntmet Occurrence I 
Occurrence 'next; 
union ( 

ushort pos2[6J: 
struct I 

ushort lo[4l : 
uchar hifAl; 
I pos3; 
long pos4[3] t 
I p; 


C 2 bytcs/occurrence 7 


r 3 hyres/occufrcocc 7 
P i bytes/occurrenee 7 


r 

There is one Wool struct for each distinct word. The word's length is stored in the 
top eight hits of the ho*h value There's no need to store the characters in the word 
since we can just look at 1 he first occurrence (first entry in Word.first) 

7 

struct Word E 
Word 'next; 

ulong hash: 

Occurrence 'last; 

Occurrence first; 

J: 


J 


\ 


void InitFiud ( 

char *textToSearch, 
long texxLength* 
void ‘privateStorage. 
long storageSize 

> 

I 

Private ’private = privateStorage: 

private->endFarsedText - 
InitFindBody( 

(uchar *)textToSearch» 
textLength, 
privateStoragc. 

(uchar ')ptivaleSLurage + storageSize 

): 


InilFmd 


if ( private->endParsedText t~ -1 ) 
private->nullChar - 
PickNtillChar ( 
private. 

(uchar MtextToSenrch + private->endFaraedText. 
(uchar *)textTo!>earcb + text Length ); 

else 

private >nullChar = NO_HULL_CHAR: 


r 

The structure of our private Storage Hie hashCodcs|] army serves two purposes it 
distinguishes alphanumeric from notvilphanumeric characters, and it provides a 
non zero hash code for each alphanumeric character The endPusedTexT field will 
be -1 if there was enough private memory to parse all the text Otherwise, it points to 
the start of the tin parsed text. nullChar is used by the BMH_ScarchO function when 
we must search imparsed text for aa occurrence 

7 

struct Private l 

along hashCodes I ALPHABET SIZE ]: 

Word 'hashTable ( HASH BUCKETS 1; 
long endParsedTex' ; P start of parsed text 7 
long ponBytfcfi; /* POSjtJJYTES, below 7 

char nisi 1 Char; /* char not appearing in the text 7 

long lump; P start of private heap 7 


Macros 

These macros simplify access to the occurrence positions stored in an Occurrence 
struct Posbytes is a macro ajgiimrni that b usual!}' set to privatOposBylc> 

However, you can also use a constant for posbytes, which lets the compiler choose 
the right ease at eomj>ile lime, producing smaller and faster code. 

V 

^define POSJLBYTES 1 P won! position fits in 2 bytes 7 

^define F0S_3_BYTES 0 p fits in J bvtes; usual case 7 

//define PCS 4 BYTES 2 P fits in 4 bytes 7 


„ InilimdBody 

This function dtx-s most of the work for lnilFindO Hie arguments have been recast 
into a more useful form; uchar and ulung are used a lot so that we don't have to 
wore}' about the sign, especially when indexing privatcotohOKlcsl], 


The return value is the character position when the unparsed text begins (if we run 
out of private storage), or I if all the text was parsed 


static long I nitFindBody ( 


uchar 

'textToSearcfi. 

long 

textLength, 

Private 

'private, 

uchar 

'endPrivateStorage 

uchar 

'alloc. 'textFos, 

long 

wordLength: 

ulong 

hash, code: 

Word 

'word: 

Occurrence ’occur: 


*textEnd. 


*wordStart: 


P 


In it table or hash codes The remaining entries are guaranteed to be initialized to 
zero. The hash codes were chosen so that anv two codes differ by at least five bits. 

V 

I 

ulong 'table = privateOhashCodea ; P reduces typing 7 


//define GET^POSfpos * occur , Index, posbytes) 

t 

If ( (posbytes) — FQS_3_BYTES ) 

pos - ((long)(occur)■>p.pos3.hi[index1 << 
+ (occur)->p.posS.lo[index]; 
else if ( (posbytes) “ POS 2 BYTES ) 
pos “ (occur)->p,pos2[index]; 
else 

pos ” (occur) >p.pqs4[index]: 

#d efine SET_POS(pos * occur.index.oosbytes) 

I 

if ( (posbytes) — POS 3 BYTES ) 

I 

(occur)->p.pos3.hi[Index] = (pos) » 16: 
(occur) >p,pos3,lo[indcx] = (pos); 

I 

else if ( (posbytes) = P0SJ2_EYTES ) 
(occur) >p.poa2[index] - pos; 
else 



\ 

tablet'O'1 

= 

DxFFCO; 

tablet*5'] 

- 

OxF492: 


\ 

tablet'1'] 

- 

OxFEO?: 

table( 1 6'] 

* 

0XF31E; 


\ 

tablet U 1 ] 

» 

0xF98fl; 

table[•/•] 

* 

0*F2D9; 

10) 

\ 

table ['3'] 

= 

0xF84C; 

tablel'8'] 
table['9'] 


0xCF96; 


\ 

\ 

\ 

table['4'] 


0xF555: 

- 

OxCESl; 


tablet’A’| 


0xC9DD; 

table f'M’J 

- 

0xA245 


\ 

table!’B*1 


OxGBlA: 

table f*0*1 

- 

0x9F0A 


\ 

tableI’C’I 

- 

0xC503; 

rsblet’P’) 

- 

0x9ECO 



table[’D* J 


0xC4C4; 

vablct’Q'j 


0x9941 



tablet’E* j 

« 

OxC348: 

lablel’R'J 


0x9886 

\ 


tablet’F’) 

* 

0xC28F; 

tablet’s*] 

= 

0x959F 

\ 


tablet'O’j 


OxAFSC: 

tablet’T’l 

* 

0x9458 

\ 


tablel'H'l 


0xAE9B: 

tablet’U’l 

“ 

0x9304 

\ 


tablet’I’l 

* 

OxA917; 

tablet'V't 

■ 

0x92!3 

\ 


tablet’J*1 


OxABDO: 

tahlet’W’i 

- 

0x61)03 

\ 


tablet*K’) 

= 

0xA5C9; 

tablel’X'j 

* 

0x6Cl4 

\ 


tablet'L'] 


0xA4QK; 

lablcl’Y’l 


0x6b98 

\ 

\ 


tablet’M'l 

— 

0xA382: 

table['Z'] 

“ 

0x6A5F 


tablet'a*] 

- 

0x6746; 

tablel'n’l 

- 

0x3C88: 
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Presenting the extra-strength text editor. 



If you thought previous versions of QUED/M 
were powerful, wait until you program with 
QUFD/M 27, loaded with these new pain- 
relieving features: 

Integrated support for THINK Project 
Manager" 6.0 & 7.0 

THINK" debugger support 
CodeWamor™ support (now it's 
easier than ever to program for the 
Power Macintosh-!) 

MPW ToolServeri 1 support 
fct PopUpFuncs^ 1 support 
^ Frontier 1 " Do Script support 

For quick relief, call 
800-309-0355 today. 


(X course, QUHD/M 2,7 still has all the features 
that make it easier to use than any other text editor 

Macro Language lets you automate 
tedious tasks 

Search and Replace through multiple 
unopened hies and using GREP 
metacharacters 

Pile comparisons using GNU Diff 
Unlimited undos and redos 
& 10 Clipboards that can be edited, saved, 
and printed 

& Customizable menu keys 
Text folding 

ees Display text as ASCII codes 
Plus many more features! 


Get even more relief: Try QUED/M 2.7 now for just $69! You’ll get a 
30-day money back guarantee too! Call now to order. 800-309-0355. 


4|ii‘ 


QLfCQAf tftf fradnshirfr Cflinspk, htC All WiW 

Air livdtnnrfc. iw d ihnr /laWto* 



107 S. Cedros Am. - $okm Beach, CA 92075 * Tel (619) 481-1477 * Fax (619) 481-6154 Soft w are /;/ c. 


tcbleLb'] 
table[ 1 c ’ ] 
table! 1 d 1 ] 
table! 1 e ’} 
table!"f'1 
table! VI 
table 1 1 h 1 ) 
tabic! ’i’1 
Labia [' j 1 ] 
table i'k'l 
table 1'i 1 j 
table l' nn 1 1 


= 0x6681 

- 0 x 610 B 

- 0x6OCA 

- 0x5D85 

- Qx5C42 

- Ox 5 BCE 
= 0x5A09 

- 0x5710 
= Ox5fcD7 
= 0x51533 

- 0x5Q9C 

- Ox3D4F 


table [ 1 o'j 
table[ 1 p p J 
table ['tp 1 
table ’ ‘r 1 1 
table'' s 1 1 
table [ * T’3 
table [ 1 n'] 
t able [ 1 v 1 ] 
table[*w'J 
table l T x'J 
table t'y'] 
table! 1 z '1 


= Ox3B04 

- Gx3AC3 
= GX.17DA 
= 0x36lD 
= 0x3191 

- 0x3056 

- 0x0019 
= UxOCDli 
= 0x0B52 

- 0x0A95 

- Gx073C 
= 0x064B 


WordStar! = textPos; 

A Search f or end of word; generate hash value too 7 

hash ** 0; 

while ( texlFus 1 = textKnd bb 

(code “ private ->hashCodes[ ’texxPos Jj I- 0 J 
i 

hash - (hash « 1) A code; 
textPoa-H-: 

1 

wordLength = textPos WordStar!; 

hash - [hash 6 QxFFFFFF) | (wordLength « 24); 


/* Determine the number of bytt*s needed to store each occurrence position. V 
if i lexlLength <- 0x1GOGOL ) 
private >posBytes = FOS_2_B-TES; 
else if { textLength QxlGOGQOQL 3 
privaxe >posBytes = F0S_1_BYTES: 
else 

privateDposBytes = POS h BYTES: 

P Set up variables to handle allocation of private storage. 7 

alloc - (uehat “l&jjriva te >lieap; 

A Paise the text 7 
textPos - textToSearch; 
textEnd = textPos + textLength; 

while { textPos != texrEnd 3 
I 

r Search for start of word 7 

while ( private. >JmshCudes l"textPos} = 0 ) 

[ 

textPoS-H-; 

if £ textPos — textEnd ) 
return -1; P parse all text 7 


Record die occurrence. I irsl we see if a Word struct exists lor tills word and 
whether we need to allocate a new Occurrence struct. 

/ 

word = LookupWord( 
private, 

(char *j textToSearch, 

[char J 3WordStar!, 
vordLength* 
hash ); 

If ( word ) 
t 

long allocateNevElock, blockSize* i, pos; 

/* 

lilts word has occurred before, so it already lias a Word struct See if (here's 
room in die last Occurrence block for another entry Remember that entry *0 in 
the Occurrence block is always in use, so we can start checking at etiiry-1 for a 
non-zero entry 

7 

occur = word->last; 
allocateNewBlonk ’ TRUE; 
switch { private >posRy(os ) 
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f 


case P0S_2_BYTES: biockSize = 6: bleak; 
case P0S_3_BYTES: biockSize * 4; break; 
case PGS_A.BYTES: biockSize & 3; break; 

J 

for ( 1 w 1; i < biockSize; i+4 ) 

l 

CET_P0S( pos* occur, i, private >posBytes ) 
if t pos = 0 ) 

I 

$ET_P0S( wordStart - textToSearch* occur, i, 
privateOposBytes ) 
allocateNewBlock = FALSE; 
break; 

J 


if ( allocateNewBIock ) 

f 

r Bkick is full, Allocate new Occurrence block 7 

occur * (Occurrence *) alloc; 

alloc +“ ALL0C_$7ZE( sixeof (Occurrence) ); 

if ( alloc >- etidPtivaleSlorage ) 

r e t u rn wo rd S t a r t -1 ex tTq Search; f* out of memory 7 

F I nit the new struct and link it to the end of the occurence fist 7 
SET POS( wordStart - textToSearch. occur, 0, 
private->posRytes ) 
word Maat-^next w occur; 
word Mast * occur; 

1 

1 

else 

[ 

long 1; 

F This is a new word Allocate a new Word struct, which contains an Occurrence 
struct too. 7 

word - (Word 1 ) alloc: 

alloc +- ALLOC_SIZE( sizeof(Word) ); 

if ( alloc >= endPrivateStorage ) 

return wordStart-textToSearch ; F out of memory y 

F Unk it to the stan of the Word list, coming off the hash table. 7 

word->next = private >hashTabie [ hash 4 HASHJIASK ]: 
private - >haBhTahle [ hash k llASil_MASK ] = word; 

F Ml the W'ord struct 7 
word'>hash - hash: 
word* Mast = iwordOfirst; 

F Init the Occurrence struct 7 

SET_PGS( WordStars texlToSoareh* &wotd Hirst* 0, 
private->posBytes ) 


F Finished parsing text 7 

return -1; 

I 


long FindWordGccurrence ( 
char ‘wordToFind, 
long wordLength, 
long occurrenceToFind, 
char ‘textTnSearch, 
long textLength* 
void 'prlvfiteSlorage, 
long storageSize 

t 

Private ’private “ privateStorage; 
Word ’word; 
ulong hash; 

r Make occurcnccToFind aero-based 7 
occurrenceToFind ; 

r Generate hash value for word to find 7 

hash ** 0; 


Find Ws >id( )i t u mure 


long remain * wordLength; 
uchar ‘p = (uchar ■) wordToFind; 
while ( remain > 0 ) 

t 

hash = (hash << 1) A private->hashCodesI'p+^J: 
remain- 
J 

hash = (hash k OxFFFFFF) | (wordLength << 


F Look for word/occurrcncc in hash tabic 7 
word - LookupWord( private* textToSearch, wordToFind, 
wordLength* hash ); 

if ( word ) 

I 

Occurrence ’occur " Aword-)first; 
long biockSize, pos. i; 

F Word exists in hash labk, so go down the occurrence list. 7 
switch ( private->posEytes ) 

( 

case PQS 2 BYTES; biockSize +* 6; break; 

case PQS 3 BYTES: biockSize “ A: break; 

case P0$_4_BYTE$; blockSize - 3; break; 

1 


while ( occur kk occurrenceToFind )“ biockSize ) 

1 

occurrenceToFind ■-* biockSize; 
occur s occur->next; 


if ( occur ) 

I 

G£T_PGS( pos, occur, occurrenceToFind* 
private->pasBytes ) 

if E occurrenceToFind ■— 0 |\ pos !“ 0 ) 
return pos; 

occurrenceToFind biockSize; 

I 


occur - word-Mast: 

for ( i - 0; i < biockSize; i ++ ) 

1 

GET_POS{ pos. occur, i. private->posBytes ) 
if { pos — 0 ) 
occurrenceToFind ++; 

J 

I 

F Not In parsed text, so check the unparsed text 7 

if { private->endFarsedText !» -1 ) 

( 

char *p; 

1T ( wordLength > 3 J 
p = BMH_Search( 

private >hashCodeU* 
wordToFind * 
wordLength, 
occurrenceToFind* 

textToSearch +- private->endParsedText* 
textToSearch ' textLength* 
prWare->nullChar ); 

else 

p = SimpleSearcM 

private ->hashCodes. 
wordToFind, 
wordLength, 
occurrenceToFind, 

textToSearch + ptivate->endFarsedText, 
textToSearch + textLength ); 

if (p) 

return (p textTuSearch); 

I 

F Nut found 7 
return -1: 

I 
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68K and Power Macintosh versions 

* full ANSI 77 native compiler 

* faster execution speed 

* graphical source-level debugging 
■ two complete graphics packages 

* make utility, MRWE application framework 

* System 7.5 compatible, MPW included 

* Windows 95/NT version also available 

absaft 


Visit us now at http://www.absoft.com 


2781 Bond Street Rochester Hills MI 48309 * (810) 853-0050 * Fax (810) 853-0108 * sales6Pabsoft.com 


r Look up a word in Lhe hash tabic 7 
static Word 'LookupWord ( 
Private ’‘private* 

char “textToSearch* 

char 'wordText, 

long wordLength* 

ulong hash 


LwkupWord 


Word 'word - private >hashTable[ hash & HASH_MASK J; 
while { word ) 

( 

I f ( word'Miash = hash ) 

( 


char *wl, *w2r 

long pds. remain “ wordLength; 


r 

The hash values match, so compare characters to moke sure it 's the right word 
We already know the word length is correei since the length is contained 
in the upper eight bits of the hash value 

7 

GET_PQS( pos* Word->f irst * 0, private ^posBytes ) 
wl - texlToSearch + pos; 

W2 = vordText: 

while ( remain- > 0 H *w]++ = *w2++ ) 

if { remain -1 ) 
return word; 

\ 

word = word >next; 

1 

return NULL; 


p PickNullChar 

Find a c haracter that doesn’t appear anywhere in the unpaged text. BMHJkarcbO i$ 
faster if such a chancier can be found 
7 

Static char PickNullChar ( 

Private 'private* 
uchar ’textStart * 

uchar “textEnd 

) 


I 

long i; 

uchar “p* occursl ALPliABET_SIZR ]; 

for ( i “ 0; ! < ALPHABET'SIEE: i++ ) 
occurs [i] - FALSE; 

for ( p *=■ textStaxt: p < t ext End: p++ ) 
occursI'p] « TRUE; 

for ( i = 0; i < ALPHABET-SIZE; i++ ) 
if ( occurs[ij = FALSE hh private >hashCodeeIi] “ 0 ) 
return i; 

return NO NOLL CHAR: 


r BMH Search 

Search the unparsed texl using the Boycr-Mootefiorspool algrvithm Ideally a null 
character is supplied (one dm appears in neither the search siring nor the text being 
searched) This allows the inner loop to be faster. 

7 

static char *BMH_Sfiarch { 
ulong “hashCodes, r prwatr->hashCbdcs 7 

char ■wordToFind. 
long vordLength. 

long occurrenceToFind , 1 0 ts first occurrence 7 
char “textStart. /* start of onparsed text 7 

char “textEnd. f* end of imparscd text 7 

char null Char f private>nullGur 7 

) 

f 

long i: 

char “text* “wordEnd: 

char word 1256]; 

long offset[ ALPHABETIZE ]; 

r 

Copy the search string to a private buffer, where 
the first character is the null chameter 

V 

word[0] - nullChar: 
for ( i - 0; i < wordLength; 1++ ) 
wocd[i+lj = wordToFindli]; 

P Set up the offset [] lookup table 7 
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Draglnstall 2.0 

Here’s proof 

that the more things change 

A New "Quick Build" option lets you build a 
complete installer in one easy step. 

A New features such as locating files and folders, 
applying patches, and replacing outdated files 
allow you to build more intelligent installers. 

A Improved support for installing non-archived 
files simplifies the creation of CD-ROM and 
network installers, 

A PowerPC-native compression and 

decompression cuts installation lime in half 

A AppleEvent and scripting support allows 
installations to be automated. 

the more they stay the same 

▼ Same pricc-$30G lets you distribute an unlimited 
number of installers for all of your products. 

No yearly fee, no royalties, no hidden costs. 

▼ Same drag-and-drop interface familiar to all 
Macintosh users. 

▼ Same reliability and robustness that developers 
worldwide have relied on since 1991, 

▼ Same support policy-free technical support and 
low (or no) cost upgrades. 

f or more information or a free demo, call 

1*800-890-9880 

or visit our Web site at 

http://www.sauers.com/draginstall 

Ray Sauers Associates 
1187 Mam Avenue, Suite IB 
Clifton, m 07011 USA 
voice: 201478-1970 
fax: 201478-1513 
email: mfo@sauers.com 


for { i - 0; i < ALPHABET_5IZE; it+ ) 
offset [ij = wordLength; 

for ( i = 1; i < wordLength: i++ ) 
offsetf wordfil ] ■ word length i; 

P Let the starch begin... V 
wordEnd w word + wordLength; 
text ~ textSt art + wordLength ■ 1: 

if £ nuilChar — NQ_NULL_CHAR ) 
f 

P No null character, so use a slower inner bqp V 

while ( text < textEnd ) 

I 

long i: 

Char * 1 q; 

for ( i = wordLength, p - wordEnd, q - text: 
i > 0 && *p = *q; 

i--. p—, q-- ) 

i = 0, we have found the search string Now wc make suit iIul it is delimited// 

if { i — 0 && hashCodespqJ — 0 U 

Uext+l = textEnd || hashCodes[text fill = 0) ) 

if £ occurrenceToFind = 0 ) 
return q+1; 
occurrenceToFind ; 

) 

text += offset [’text]; 

I 

I 

else 

I 

P There is a null character (usual case), 
so wc can use a faster and simpler inner loop. 7 

while { text < lextEnd ) 

I 

char *p* *q: 

for £ p “ wordEnd. q = text; — 'q: p , q ) 

if ( p = word hh hflflhCodes t*q] 0 hi 

(text+1 — tcxtEud || hashCodes[textUJJ == 0) ) 

1 

if £ occurrenceToFind — 9 1 
return q+I; 
occurrenceToFind--; 

1 

text offsetf“text]: 

I 

I 

return NULL: 


^ SimpLcScardi 

Search Uie unpaged text usinjj a simple search algorithm Note that wordLength 
must he I, 2, or 3. This alfiorithm runs faster than HMH_Scarcb0 for small search 
strings 
7 

static char 'SlmpIeSearch£ 

ulong “hashCodes. P privatohashCodes 7 

char ‘wordToFind, 

long wordLength. P I..3 7 

long occurrenceToFind. P 0 Is 1st occurrence 7 
char -text St art, P start of unparsed text *f 

char “textKnd P end of all text 7 

) 

I 

char ‘text, first: 

first “ vordToFindtOl: 
text - textStart; 

1f £ wordLcngih 1 ) 

l 

while ( text < textKnd ) 

I 

while { text < textEnd hi “text 1* first ) 
text+f; 
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if { hashCodest*(text-1}J = 0 

hashCodes [text [wordUngth]] — 0 ) 
t 

if ( occurrencetoFind “ 0 ) 
return text; 
oceurreticeTofittd ; 

I 

text++; 

I 

I 

else if ( wordLength M 2 1 
[ 

while { text < texlEnd ) 

( 

while ( text < textKnd && ‘text != first ) 
text++: 

if [ text 111 wordToFind[1| && 
hsfihCftdes[*(text-131 == 0 && 

ha^hCodes [text [wordLength] ] = 0 ) 

I 

if ( 0e£ti r retie ?To Find = 0 ) 
return text; 
accurrenceToFind--: 

I 

text++; 

I 

I 

el rc f wmtftengfh a 5 7 

l 

while ( text < textEnd ) 

I 

while ( text < textEtid && ‘text !■* first ) 
text++; 

if C textfll “ wordToFindfI| A& 

T*xt|2| wnrdTnFl nd [2j 
hashCodes[*(text I)] 0 ttk 

hLishCodeti [text [wordiengtli] ] — 0 ) 

I 

if ( occurrenceToFind == 0 ) 
return text: 
occurrenceToFind--; 

I 

text+ h 

J 

1 

return NULL; 




DON’T FORGET! 


To receive information 
on any products 
advertised in this issue, 
send your request 
via Internet: 

productinfo@xplam.com 


You’ve spent 

enough 

time in 
development. 

Don’t let your 
installer keep 
you from going 

golden. 


User Specified folder 
E User specified Ork 
(Q Startup Disk 
Q Desktop 

Cn Hctiue Hppte Menu Items | 
G3 Bctiue Control Panel* 

@1 fit liue intensions 
S3 tttliue lonts 
£D Htliue Preferences 
Si Httiue startup items 
I Rctioe System Folder 


^Boy Processor 
Any 6 GQhO 
Any PowerPC 
60000 
60020 or higher oBdhQ 



Just because your 
software is done doesn’t 
moan your work is. You 
still have to write an 
installer. And that can 
add precious days or 
even weeks. 

With Aladdin 
Systems' proven 
installation standard, 
Stufflt InstallerMaker, 
you can have your 
PowerMac* or (»80x0 
product ready to siiip 
literally within minutes, 
and save money to boot. 

Stufflt InstallerMaker 
uses our advanced 
compression technology 
to reduce the number 
of disks needed to ship, 
which saves you money 
on every unit.. Its menu- 
driven interface is so 
easy-to-use that even 
your VP of Sales could 
prepare your installer. 

New version 2.0.2 
adds full PowerMac 
support, improved 

scriptability, 
and 

expanded 
localization, 
including German, 
French, and Japanese. 

To receive a free, 
fully-working copy of 
Stufflt InstallerMaker, 
call our licensing 
department today at 
(408) 761-6200. 


ihlermm 


C |HH AL*ddlu 3)Jtmn Inc. IflS Dth* 

W**#*1UM* mm P«X (WJ7EJ fciufi Auwi 
lhihiir T ApplH Jnfc AljtfOK limm*- 

in«4kti(tiJiEr H4in*km*i4: ef 
UmW-Jn fyiirtu, Inr All ItfinHKW AH? 

Lnliwiuix iMt maqaiTiiYf hN*lrn 
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SCRIPTING 

ARCHITECTURE 


By Jeremy Koscbelle 



Attaching a Scripts Menu 


An introduction to 
using the OSA in 
PowerPlant 


A fully Apple Event-savvy application is 
scriptable, recordable, and attachable. 
In a scriptabie application, any user can 
automate tasks, interconnect applica¬ 
tions, and extend the capabilities of your 
application. A recordable application 
generates a script by observing the 
user's actions. Yet these capabilities 
prove worthless if users have no easy- 
way to execute their scripts. 
Unfortunately, Apple did not provide 
any standard human interface for 
attaching scripts to an application. And 
although the PowerPlant framework 
provides excellent support for scripting 
and recording, it provides no recipes for 
customizing your application to launch 
scripts. This article addresses these 
issues with a simple customizable 
Script menu which allows users to 
execute scripts (see Figure 1 )♦ 

At first, implementing a .script menu 
looks complex; it requires interacting 
with PowerPlant, the Menu Manager, the 
File Manager, the Open Scripting 


Architecture (OSA), and the scriptabie Finder. On the bright 
side, PowerPlant and the OSA provide excellent modular, easy- 
to-use interfaces [see Jeremy's article, Towering Up AppleEvents 
in PowerPlant", Mac lech Magazine, 11:6 (1994) 33-46 - man L 
In this article, I ll present an implementation of an extension to 
Lite PowerPlant framework that that can compile and execute 
scripts from a standard pull-down menu. This script menu 
provides a relatively complete implementation of attachable 
scripts: it loads scripts at launch time from a “script menu items” 
folder, automatically supplies Balloon Help for each menu item, 
and can open a script for editing in the Script Editor. This article 
will also show you how easy it is to use OSA to compile and 
execute scripts. 


Script |'m 

Hello mo rid 


Mill to Front 


Rttach Script... 




displays 

HelloWorld 

dialog 


Figure 1. The Script menu 


The implementation also strives to use the capabilities of 
PowerPlant, 0\ and AppleEvents to achieve modularity and 
encapsulation. For example, we use the LAttachment 
mechanism to encapsulate all the code for handling the script 
menu into a re-usable class. Likewise, we introduce a C ++ 
iterator class for scanning through items in a folder. Finally, we 
use AppleEvents to connect our script menu to external 
applications that provide script editing services, thus avoiding 
the need to embed a script editor ourselves. 


Jeremy Rose belle - Jeremy Koschelle works for the University of Massachusetts, at the, umm* “San Francisco campus.” From 
his spacious, bedroom-like, comer office, he is developing software to help students learn "the mathematics of change” with 
interactive graphs and animated characters. Crossing “Doom” with Calculus provides a positive outlet for responding lo 
traumatic memories of past mathematics teachers. And because his Ph.D. is in education, there's hardly anything else he ! s 
qualified to do. Contact jeremy at jeremy@dewey.soe,Berkeley,edu. 
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OSA Basics 


From the user's point of view, a script is a small program 
written in AppleScript or another OSA dialect. From the 
programmer’s point of view, a script is a data type containing 
code that the OSA can execute. The process of compiling a 
script reconciles these views: compiling converts AppleScript 
statements into an executable data type. 

As a programmer, you manipulate a script as a Handle to 
some script data. The easiest way to get such a handle is to get 
the ’ sept * 1 resource out of a ScriprFditor document. There is 
one ’sept 1 resource in each ScriptEditor document, storing 
the script compiled by the user. 

To run a script, you first load the script data into OSA. 
This results in an OSAID, a token that refers to the loaded 
script. The process of loading is relatively slow (a second or 
two on my Quadra 66QAV). Once a script is loaded, running u 
is fast (small scripts seem as fast as hard-coded commands in 
my application). To execute the script, you pass the OSAID to 
the QSAExecute function. When you are through with a 
script for any value returned by OSA), you dispose of its 
OSAID to free up the associated memory. 

To hide the ugly details, I wrapped my code in a utility 
c lass with sraric methods: 


void ^Sculpting: . initialised Uiuipting..Initialize 

I 

// Component is a static class member of type Componentlnslancc 
if (sComponent nil} 

SetComp orient ( 

: :OpenDe fault Component (kOSAGatnponentType, 1 scpL') r 

1 


LFSeripiing: :LoadScript 

OSErr UScripting;:LoadScript{ 

Handle inSeript. 

OSAID &outScriptlD) 

( 

Initialise(): 

AEDesc scriplDesc; 

scriptDesc^descriptorlype - typeOSAGenericStorage: 
scriptDeac.dataHandle = inScript; 
return :;OSALoad(sComponent. 

&in&eriptDesc t 
kGSAHodeNul1, 
fifOulScriptID): 


[ JScript ing:: RxeaiteSeript 

OSErr UScripting:lExecuteScript( 

OSAID inSeriptID) 

l 

Initial i?.e(); 

OSAID reaultID; 

OSErr err : 

err - : :OSAExectite (sCQmpGn.e.nt, 

InScriptTD. 
kOSANullScript, 
kOSAModeNull h SresuItlD); 

if (err) 
return err: 

else :rOSAHispose(sCoraponent. rnsultID); 
return noErr: 


TCP/IP Scripting Addition 


The Internet Scripting Solution 

The TCP/IP Scripting Addition allows you to quickly 
develop Inlernel client/server applications using 
AppleScript®. If you want to script with MacTCP™ and 
Open Transport™, here's your solution! 

♦ Supports Script Editor, FaceSpan ™, and HyperCard™ 

♦ Build net-wise WebSTAR™ CGI scripts 
and NetScape™ CCI scripts 

♦ Sample scripts include FTP, Gopher, 

Telnet, Post Office, E-Mail and more 

♦ Featured on the Apple® Internet Server 

Order now through the MacTech Mail Order Store at 
805-494-9797 or other mail order stores 

fJIM I Mango Tree Software, Inc. 

MJga I Box 105 7 * B rookli n e, Massach u setts 02146 

1 617-327-8663 * http://www,mangotree.eom 

All trademarks are properties of their respective holders. 

Contact Mango I ree Software for sile licensing and redisiribulion information. 
Copyright © T996 Mango I reo Software, Inc. 


Design Overview 

The main challenge in designing a script menu is maintaining a 
correspondence between items in a Menu Manager menu and 
scripL data that we can execute. This script data (an FSSpec for 
a script file and an OSAID for an executable script) will be 
encapsulated by a class called SCScriptMenuItmru Because 
scripts will be added to the menu dynamically, we cannot 
specify the menu items ahead of time in our resource file and 
cannot use PowerPlanfs 'Mcmd 1 scheme for binding each 
menu item to a command number. Instead, the implementation 
builds a list of SCScr i ptMenuI Lems, where the index of the 
item in the list matches the index of the item in the menu. 

Our application must use this correspondence to respond 
when the user selects an item from the Script menu. We 
could do this by overriding [.Application methods that 
handle menu commands. But PowerPlanL s LAttachment 
class provides a better solution. It allows the code to be 
completely encapsulated in a class, SCScriptMenuHandler. 
This class can be attached to any PowerPlanL application with 
one AddAttachment call. (Such modularity and portability 
can be dangerous - your employer may come to expect it 
regularly!) 

Your application will normally create one 
SCScriptMenuIIandier at launch time. When created, this 
object will iterate through the designated folder and create one 
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Richey Software Training provides 
professional, customized programming 
seminars and industry consulting. 

Rich content ik hands-on lab 
exercises shorten your learning curve. 
On-site training is convenient - your 
team eliminates expensive travel casts 
and consuming down-time. 

Professional training & consultant ) §§ 
thu t tea fly hits th e met rk. 7 7 

Call today to find out how Richey 
Software Training delivers professional 
seminars and consulting nationwide. 


MAC 

SEMINARS 


■C&C++ 

■OOP 

■ MacApp 

■ PowerPC 

■ AppleScript 

■ MPW 

■ System 7 

■ Debugging 
‘SourceRiig 


RICHEY 

B 


Trahniif; Muc Proj^mnnuTS' Sintrr 19H4^ 

707 * 869*2836 

AppleLink: HlUiESYSQIT 
1STERNBT: 7011C271 LKscumpusetvex( nn 
H.O UOX Italy. CiUONTmLErGA jaw 


MacOS menu item and a corresponding SCScriptMenuItem 
for each script in the folder When a user selects a script from 
the memi for execulic>n t>r ediLing, die SCScriptMenuHandler 
calls the appropriate method of the corresponding 
SCScriptMenuItern. 

The article covers the implementation starling from the basic 
structure of SCScriptMenuHandler and SCSc r ip t Menu Item. 
Next, the article describes how to create Balloon Help for each 
script automatically. Finally, the article reviews the utility 
routines for interacting with the File Manager. 

Creating the Script Menu 

Like every menu, the Script menu requires a 'MENU 1 
resource, a 1 hrrmu* resource for Balloon Help, and a reference 
to the correct ID in your 1 MBAR T resource. The ’ MENU r and 
'hmnu' resources contain the fixed portion of the script 
menus: the menu Lille and a final menu item that allows the 
user to add a script to the menu while your application Is 
running, (This additional feature is supported in the sample 
code, but not discussed in ibis article.) At run-time, we add 
additional menu and help items for each script. 

In your application, you create a handler for this script 
menu, normally within the constructor for your application 
class. When creating the handler, you provide the resource id 


for the script menu, and the vRefNum and dirlD for the folder 
from which you wish to load scripts. 


YourApp::YourApp() 


YourApp constructor 


// get folder id and volume number for the Scripts Folder, relative to launch spec 

FSSpec appSpec; 
long folderlD; 


UFinder:: Get AppSpec(appSpec); 
folderlD = UFinder;:GetFolderID( 
appSpec, "\pScript Menu Items"): 


// attach a new handler for the scripts menu 

Add Attachment ( 

new SCScrlptsMenuHandler 1 kSeriptsWenuTD. 

appSpne. vRefNtia* 
folderlD)); 

I 

When SCSeriptsMenuHandler is constructed, it iterates 
through a folder, appending a .script menu item for each script file 
it finds. To hide the ugly details of iterating though a folder, the 
implementation uses an iteration class, StEolderlterator. 


SCScripbMcnul landler constructor 

SCSeriptsMenuHandler: :SCSeriptsMenuHandler{ 

Re a IDT inKenuID. 
short inVRefNum, 
long inParlD, 

IntlG inMax] 

: LAttachmem (msg_AnyMessage . true), mtfenu ID (intent ID) 
t 

// appends menu items for each script in the designated folder 

if (inVRefMuin !*= 0) f 
// set up iteration structs 
Inti6 count * 0; 

Str255 scrlptFileName: 

HFileParatn fInfo; 

flnfo ToNainePtr = scriptFileName; 

// iterate through each item in the folder, inserting scripts 
StFolderlterator iterUnVRefNum* InFnrID )\ 
while ({++coutvt <~ inMaxl iter, Next (finfo)) 1 

if (flnfo.ioFlFndrlnfo.fdType = kOSAFileType) I 
FSSpec spec: 

FSMakeFSSpec [ 

inVRefWuin. InParTD, sctiptFileMame, &spec); 
AppendSuript(spec); 

I 

\ 

1 

I 

To append each script, we first grab the menu. Then we 
insen an item into the menu, using the file name as the menu 
item name. To handle each menu item, we build a 
SCSc rip t Menu Item and insert it in the mScripls list, such 
that index numbers of the JVlaeOS menu iLern and the 
SCScr i ptMenultem correspond. Finally, we construct 
Balloon Help (as described later). 


SC Se r i p tsM enuH andler: lAppt ndSeript 

void SCSc riptsMetiulland lor :; Append Seri pt ( 

FSSpec kinScriptFile) 

McnuHandle mmn : :GetMenu{mMemiID): 
if £1 menu) return: 

SCScripLsMenuTtern “item - 

new STScriptsMemiltem(inScriptFi le); 

// insert into die menu 
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Can you spot 
the difference? 



: ilnsHenuItevri 

menu, inScri ptFi Ivoitune, jnScrlpts* Get Count 0 ); 

// Insert \hc corresponding digs Instance into the list 

rcScripts.InsertItemsAt(1, arraylndex^Last. i 

// Insert balloon help Into resource 

ATtachBalloonKelpUnScr f ptFi le* mScripts .CetCount 0 ); 

I 


Running a Script 

As described earlier, running a scrip! in the OSA requires two 
simple steps. First you load the sc ript, resulting in token called 
an OSA tf) that represents the executable. Then you pass the 
token to the OSA execute function. 

Running scripts from a menu is only slightly more 
complicated. The AppendScript procedure created a 
SCScript Menu Item for each menu item, storing die FSSpec 
of a script file. To compile a script we need to extract the 
'sept * 1 resource from this file and pass it to OSALoad to get 
an OSAJD. Because loaded scripts execute much faster, we 
load the script and store die OSAID to service future requests 
to run the same script 


SCScriptsMemi Handler: RuoScdpt 

OSErr SCScriptEWsnuIten:;Run5cript() 

t 

QSErr err ** noErr; 

// load the scripi if its not available yet 
if fuScriptlD = kGSANun Script) \ 

Handle script: = nil, teal D nil: 
short fRefNura * -1; 

Try_ t 

// open resource fork 

fRoINim - :: FSpGpenResFiie (kmFileSpp.c, fsftdPcrmJ ; 
ThrovIflesError_0 ; 

// gel the fitst script resource m the file 
script - ;:GetllndR^Sourcot'sep* 1 , I); 

FallKIL (script): 

// Load it 

USrri pt ing:: Loud Script (script , mScriptlD); 

I 

CaLch_(catehErr) 1 
err “ catchErr; 

SysBeep(O): 

I 

EndCatch 

if (fRefMuii 1- 1) : :CloseResFile(fRefNunt): 

1 

if (err = noErr) new URunlScript (naSr r I pt TD); 
teturn err: 


Testing reveals one additional complication. If die script 
brings a different application to the front while you are still 
handling a menu selection, a menubar drawing glitch occurs. To 
solve ibis problem, we create a LPeriodical task that runs 
immediately after die menu event completes (and the MacOS has 
removed the menu hiliting). URunlScript simply executes a 
loaded script With a given OSA1D and dien deletes iiself. 

URunl Script constructor 

LfKurii Script;: URunl Script (OSAID InScriptlD) 

: mScriptlD(inScrlptlD) 

1 

StartRepeatingO : 

1 


Pleniy of people can't, Because whether you update software w ith a 
full set of program disks, or a file made with UpdateMaker 2, die result 
is the same. Guaranteed. L pdateMaker updates are totally tellable 
Its system of 32-bit checksums ensures that it updates the right file 

And UpdateMaker is easy-to-use - simply specify the files and 
UpdateMaker builds the update. There Is no scripting or use of 
ResEtlii It's even easier for end-users - just tine button to press. 

UpdateMaker 2 works with any type of Macintosh file. The updater 
files are extremely compact And the program options numerous. 
You can presave or override user customisation*. Save hies in Binhex 
formal Update up to 20 old versions with one file. 

Tite real difference is the savings in time and money. Which 
explains why some of the best known names in software 
development Iiave already discovered UpdateMaker 2. 

Distribution is unrestricted and royalty Tree. 

Only $225, order now, fax (415) 964 2886 

Appldink: Mac LthOQT Jnlc riicuMacLabilir IA |j pit I ii i k. Appkccom 

UpdateMaker 2 


ADInstmmetits, 222? Grant Road, Suite #4, Los Altos. CA 94024 Phone: (415) 28~ , 8 


. . ___ , URunlScript.:Spcmirmic 

void URunlScript: :SpendTj iDe( 

const EvftntRe.r.ord SinMacEvent) 

( 

tIScr t pt. i n%i ;RxeeuteScript (snScriptlD) ; 
delete ihia; 


Handling The Menu Selection 

Handling menu selection in an LAttachment is a matter of 
overriding ExeeuteSelf, When die user selects the menu 
item, PowerPoint will generate a negative command number 
(because the menu has no T Mcmd‘ resource). The menu id 
will be in the Hi Word, and the item number in the LoWord. 

Our handler must respond both to this command and to a 
command status message that enables the menu item. Since 
scripts are always available, we enable all menu items in the 
script menu. To respond to the command, we find the 
corresponding SCScript Menu I lent. Normally we run die 
script. However, if the command key is down we open it for 
editing. The methods for running a script were described 
aix>ve; the next section explains how to open a script. 

SCScriptsMen uHandlcr:: ExccuicScIf 

void SCSeripisMenuHandler : :ExecutfcSe! f ( 

Message! inMessage. 
void ‘ioParstn) 
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Bug Tracking the Macintosh Way 


TestTrack automates and simplifies tracking your bugs so you 
can concentrate on fixing them. Easy to set up, easy to use T 
and quick loo! 

£ Track bugs, change requests, testers, 
configurations, and more 

# Produce concise reports 

$ Automatically route bugs to team members 
$ Minimum setup time 

* Multiple users, full security 


for morr ififotTnalion, call m send e-mail Lo $capinc@onc,nfl 



Srijklor Hafhvirt', Inc. 

iQS&ScapInr Court 
MajnmIlc.Cn 

W.til5606 


sExeeuteHoet “ true: 

// update status 

If (InHesrsa^G “ nts^CominandStatus} I 

KCumnmndSt a tus ‘status = {SCaamandStatus *)ioParam: 
If (HiWard( status >cowmand) = mMenuID) I 
•status-Enabled = true: 

■ status->usestterk = false; 
mExeeuteHost - false; // wchandled it 
I 

! 

// handle menu oomand 

else If (HiWord£ tnMessage) = mMenuID) { 
lntl6 index = LoWord(-tnMessage); 

SGSeriptsMenuItetti ‘ilea; 

If (mSe t iptfi,FetchitesuAt{index. 4rilcm)) f 
if (rmdKey & UEventUtils;:CetModifiers0} 

1 ten >Open$ctript C) ; //open on command key 
else itejn->EunScript0 : 
uiExectUeHost = false; //wc handled it 


i 

i 


Editing a Script, the AfpieEvfnt Way 


we can open a file in SeriptEditor and let it handle editing. 

Since we already have an FSSpee for each script in our 
menu, this is easy. Our SCScripuMenuItem method for 
opening a script calls a utility method to send the Finder an 
“open" event with the FSSpee. Before doing so, we dispose 
of the token that represents the loaded script. By doing this, 
we will force our RunScript method to re-load the script 
from the file. Thus, when the user edits and then saves the 
script, her next attempt to run it will load and execute the 
modified version. 


A ., SC;StriptsMcmiItan::OpenScripi 

QSErr SCSc riptsMenultefe::OpcnSc r Lpt() 

\ 

If (mScriptlD !* kOSANuIlScript) f 
// first unload .script from OSA 
UScripting: :MsposeScript (raScriptlD)) 
uScriptTD “ kOSANu11Script; 

) 

return UFinder:tSendFinderAEOpentmFilfiSpec); 


We could send an “open" event to SeriptEditor, hui instead 
we send it to the seriptable Finder. The Finder will open the 
correct scripL editing application based on the creator of the file. 
Sending an AppleEvent is not hard* The first step is to 
create a descriptor for the target of the event, in this case the 
Finder. The easiest type of process descriptor just uses die 
application signature. The second step is to create an 
AppleEvent with this process descriptor. The third step is to 
add any parameters to the event. In this case there is just one, 
the FSSpee. Final ly we send the event and dispose of the 
reply. 

The implementation uses exceptions to handle an error at 
any stage of the process, but it catches all errors, disposes of 
the memory in AEDescs and returns the error code. 


OSErr UFinder::SendFinderAEOpen( 
FSSpee SrinFMc) 
l 


IJ Finder: :5cndFi nderA EOpen 


OSErr err = ntiErr: 

AEDese processDesc: 

AppleEvent ae* aeReply; 
ae.descriptorType * 

aeReply.descrlptorType = 
proc GGsDesc ,descr iptorType - typeNull: 
ae .dataflandle = 

aeReply *datallandle " 

processDeac.dataHaridle - 

ail; 


Try_ I 

DescType f inderType - 'MACS*: 

err - ::AEGreateDesc £ 

typeApplSignatUre, 
AfinderType, 
sizeof(DeacType), 
iprocessDesc); 

FailOSErr (err): 


Providing support for users to edit scripts is nor hard. OS A 
provides calls tliaL get die text and style record for a script, which 
you can display in an LTextEdit. pane. When die user finishes 
her changes, you can use OSA calls to compile the script, and then 
execute it. But them is an easier way: the SeriptEditor already 
provides full script editing capabilities. By sending an AppleEvent, 


err = : :AECreateAppleEvent ( 
kCo r eEven t Cl a s 3, 
kAEOpen, 

SprocessDesc , 
kAutoGanerateReiurnil) . 
kAnyTransactionlD. 

&ae) \ 

FailOSErr_(err): 
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err - : rAEPutPamuPf r( 

&ae, 

' keyDIroctObject, 
typeFSS, 

AinFile f 

sizeofCinFile)); 

FailOSErr_(err); 
err = ::AESend( 

&ae. 

tauReply* 

kAKNoReply | kAENeverInteract * 
kAFNo rural Pr iori ty * 
kAEUefauitTimeout, 
nil, 
nil); 

PailOSErr_(err)i 

) 

Catch fcatchRrr) t err " catchFrr:I EndCaxch_ 

if (procGtfSDcgc .descriptorType (- typeNull) 

:sAEDisposeDeac CfrprocessDesc); 
if [ae.ikscriptorlype 1- typeNull) 

;:AEDisposeDesc(&ae): 
if (aeReply.deseriptorType typeNull) 

v :AEDieposeDeac(AaeRep1y); 
return err; 


Writing Balloons Without Typing 

As a final touch, it’s nice to provide Balloon Help for all menu 
items. Bui scripts are loaded at run time, so there’s no way to 
know in advance what scripts will be present. Yet there is a 
way to automatically create seasible help text for each script at 
run lime. Here's how. 

When a user creates a script in Script Editor, the user can 
write an English description of the script in the area just below 
Lhe window title. This description ends up in a ‘TEXT’ 
resource in the script file, 'lhe script menu can grab this text 
from the file, truncate it to 255 characters, and install it as 
Balloon Help for the menu item. Thus, the Script Editor 
description field becomes the Balloon Help automatically. 

Here is the lop-level routine that is called when the 
SCScri ptsMenuHandler is constructed. 


SCScriptsMcnuHandlcn At tadi talk wnl Idp 

void SCScriptsMemiHan&ler; :AttachRalloonHelp£ 

FSSpec AinScripf File. 

IntlS inTndnx] 

( 

5tr235 lcxi; 

1 

//go ihcicxl 

Intis fRefNum - 

;: FSpOpenResFi 1 fi (AinSc r EptFile, f^KdFerin); 
if {ResErrorO) return; 

// the flrit irxt resource has the description uf the script 
Randle outtext “ ::GetIIndResource('TEXT*. 1): 
if tontText) 

UFinder;:Handle2PSir(outText, text); 
else 'text * 0: 

;;CloseReaFile(fRefHum}; 


l 

// add the hdp 

char buffer 15001 ; 
HakeBalloonDataftext, buffer); 
InsertBalloonData(Inlndex* buffer); 

I 

) 



Once we have extracted the description text, the process 
of installing it is divided into 2 steps. First we construct a 
buffer containing a single entry for the 'hmnu * 1 resource. Each 
entry begins with a size word for the size of the entry, and then 
a flag word indicating the type of the entry. Wc only deal with 
two kinds of entries, a “skip" entry for empty balloons, and a 
direct string entry. A direct string entry has 4 packed Pascal 
strings. The routine below writes an entry in this format, 
implementing the writes as if writing to a stream. 


SCStripfcMcnuHamller: MakeMix ml )ata 

void SGScriptsHenuHandler:;MakeBalloonOata { 

Str255 inHelp. 
char *ioBuffer) 

I 

Intl6 mark* data; 
zeros » 0; 

// leave room to write number of bytes to t tid 

mark « 2; 

if (‘inHelp — 0) I 
// no data, so skip this item 

data = QxOlOQ; 

;:B1 orkMoveData (&daLa „ lohuffer Lfflark] . sizeof(Inti 6 )) : 
mark +“ sizeoftlntlb); 

I 

else I 

data = 0x0001; // direct siring type 

: -BlockMoveDatsC&data, [mark], isiy.cof 11nL16)): 
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hull 


is a collection of live menu defini¬ 
tion resources (MDEFs) that youjust 
paste into your project’s resource file. 

Build a menu using the MDEF and 
then just handle men u selections like any 
normal menu. 


SI) luiris > 

IV»I. 


Cnlort * 

PM 


ASCII thorl ► 



rhis vpai ► 

4 ClHMd 
• Bulk* 



Also contains Mailre d’, a special menu develnment tool 
that assists you in designing your MENU MILL Menus. 


MENU II 


IS 


■ Use your drawing programs as programming tools 

■ Fast unohtrusive RGB color picker 
Space saving Geneva 9 MDEF 

• Calander Menu 


JUST...' 


Write. Ariel Publishing, Inc. 
11A Leisure Time Drive, 
Diamond head, MS 39525 
Call (601) 255-6713 
FAX (601) 255-7086 

DEVELOPED BY STAZ SOFTWARE, tNC 


$69.95 


Hia rk 4* s i xeof [Tut 16); 

// write out the string 

: tBlackMoveDatatinileip, bloBuf ter [mark] , 1 + MnHclp}; 
stark +- 1 + Unifelp; 

ff write out three zeros fur the other strings 
::BlackWov@Data(Azeros, fciaBuffer[aarkl, 3); 
mark +■* 1; 


// align buffer to an even word boundary 

if (mark A 0x0003) ++m*irk; 

// add size to first word of buffer 

: iBlockMoveDfltflUniark, ioBuffer, slsseof (mark)) i 


Balloon data for a menu is packed into a single Handle, 
In order to insert an entry for a new menu item, we need to 
increment the count word, and then insert the entry' in the right 
place. To find the rigid place we have to read the size of each 
preceding entry, and skip over that many bytes to arrive at the 
next entry. Once we find the right place, remaining entries are 
moved out of I lie way, and the new entry' is copied into place. 

SCScri pisMen uHandler: InsertBalloonDflia 

void SCSeriplsMeiiullandlcr : ;ln&erUbiil6anI)aL« ( 

Intlfc inlndex, 
char HnBulfer) 
t 


Handle hranu " :: Get 1 Resource ( * 1 hianu 1 , mKenuID ); 
if (! hmiiu) return; 

Intl6 ien - “(short *)ioBuffer; 

// make some room in Llie handle 

:!SetEandleSize(hmnu, ;iGetHandleSise(hmnu) + len ): 
if {: :HeaiErrar ()) return: 

// k*1c it down so we can safely' dereference it 

StHsndleLockec lock(hninu) s 
char “help = 'hranu: 

// increment number of items 
1 I * (short *) (help + OxOA); // hetp + OxOA 

// skip over existing Items 
f 

// skip default and title resource, don't skip self 
Intl6 itemsToSkip “ inindex +21; 
help += OxOC; // kieatiun of first img record 
da ( 

help t= “(Inti 6 *)help; // add the number of bytes to skip 
I while {--iterasToSkip); 

I 

// shift data out of the wav 

( 

char ‘dest* “end; 
dest = help + len: 

end = ((char “)“hmnu + ::GetHandleSize(hranu)): 

::Bint-khovetiata [help, dent, end * dest); 

I 


// copy lie Ip data in 

::BlockMoveData(inhuffer. help, len); 

) 

Note that the implementation does not call 
Changed Resource, even though it did change the resource. 
This is because the resource is in the application, and calling 
ChangedResource would cause the application to store the 
Balloon data when it quit. We don't want this data stored; it is 
recomputed every lime the application is launched. We also 
don't call ReleaseResource, so the changed resource will stay in 
memory' for the duration of the session. 

Finder Utilities 

The implementation made use of a few Finder utilities: (a) for 
finding the FSSpec of the running application; (b) for finding a 
folder id, given a parent folder and a folder name; (e) for 
iterating through all the Items in a folder. These are fairly 
common steps in many applications, but the techniques are not 
easy to find in standard Macintosh references. For the sake of 
completeness, the routines are presented l>clow: 

To find the FSSpec of Lite running application, you call the 
process manager, requesting information alx>ut the current process. 

UFmder::GcLAppSpce 

IfFinder; :GetAjrpSpec { 

FSSpec fcinSpec) 

I 

FrocessSerialNumber psn; 

ProcessInfoRec info: 

infa.processAppSpec = fcinSpet; 
info.processXnfoLength - sizeof(info); 
infa.processName = nil: 

: :GetCurrentProcess (Span): 

; :Ge1 Process!nformsHan [Apsn * Ai nfo); 

I 
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We find the folder of scripts by finding the folder that the 
application was launched from, and then looking for an enclosed 
folder named Script Menu Items- The routine below finds 
an enclosed folder id, given a parent folder and a name: 


long UFinder::GetFolderID( 

FSSpec ^inParentFolder. 

Str255 inName) 

{ 

CInfoPMec pb; 

Dir In To *dpb - [DlrTrtfrj ‘l&ph; 

OSErr err; 


U llnder :GelTokterlD 


dpb->ioNamePtr = inName ; 
dpb->ioVRefNujn = inFarentFolder. vRefNum; 
dpb-MoDrDirlD = inParontFolder.parlD; 
dpb->iaFBirIndex = 0; 
err - PBGf*r.CstTnfo(&pl>- falsa); 

if make sure its a folder 

if {err = noErr && dpb->ioFLAttrib & { 1 4}} 

return dpb->ioDrDirID; 
else return 0: 


The recipe lor iterating through each item in a folder is really 
ugly. The class Ixdow encapsulates Lite details in an iterator: 


rt , , StFoldeTltcmor constructor 

S Lbolder!LOtaLur:;Stbolder Iterator{ 

short inVRefNum. long InFolderlD) 

: raVRet'Num(inVRefNuni). mFolderllUinFolderlD), mlridex(G) 


I 

I 



Script Debugger 

Script Debugger is a powerful and flexible AppleScript " auilmring tool that makes 
il easy for novice ami cxjHriimml scrip! writers to gel die most front AppleScript. 


Lore flight 

SOFTWARE 


mm 


uJc^raiFa 


Script Debugger 

_■; m ■ Offers true single-stop execution of 
g oil AppleScript scripts 

i Provides u powerful scripting environ¬ 
ment that includes Drug £ Diop drhng 
i Is Powei PC Native 
i Is saiptnhffi and attachable 


r=^i 1 

|UUfcM|| 


— «»*»*w-**~* 




",.. die program /Script Debugger! 
is a solid performer, and its support 
for large file sues, helpful 
Dictionary window, superb scripting 




•: i? 




make if o vsty good choice. “ 
Avi Ruppuporl and Ed Allen 
AfnriVfkWngnnnf! 


*129 


Lute flight Soflwme llrl 
Voice (604} 929-5578 
Fax (604)929 4961 
E mail gtubiri^wiinseyaani 


, ( , StFo Id e tit orator: Next 

Booletm SfcPulderIterator; ;Next ( 

HFiieFaraia kioReel 

I 

i oRec.i o VRe fH um * mVR a fNurn; 
ioRec.ioDirlD — raFoldftrlD: 

// reset name Held 

if (ioRe*r . InNamoPt r) ioRftc. [oNamfcPt.r [Q] = 0: 
i&Rec.ioFDirIndex “ ++mlndcx; 
ioRec,ioResuit = noErr: 


BBVDKra 

% 

UNMStTY' 

It’s not just the basics anymore ! 


PBHGetFInfo((HParmBlkPtr)6ioRec, false); 
return (IoRec.ioResult — noErr); 


Conclusion 


Advanced courses from Developer University 
gel you up to speed quickly on new Apple tecbaolugiess 

□ OpenDoc 


Scripting acids very powerful capabilities to your application. 
The script menu makes it easy for users to attach scripts to a 
menu in your application. And the code is encapsulated in an 
LAttachment. ■$* 


□ PowerPC 

□ Newton 

□ Graphi cs/Imagi rig 
U Apple Guide 


Visit MacTech Magazine’s Wei) site! 

http://www. mactech.com 


Courses Available as 


Self-Paced Classroom lecture Online 


For more derailed information, cheek out our World Wide Web pages, 
http:/;Www.info.apple.com, or contact the Apple Developer University Registrar 
ai (408) 9^4489” or fax (408) 974*0544 

Developer University. Apple Computer, Inc. i Infinite Loop, MS 30MTL, Cupertino. CA 95014 
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UNIFORM 

RESOURCE 

LOCATORS 


By Jim Straus, UKU@mactecb.com 



Spare your fingers and find the full list online at: 

http://wvwTAf.mflctech.tom/URLs.htm1 

Or (fur a limited Lime), .send mail to: MacTeth URLs@dass.com 
and you will receive the latest list hack. 


Internet Related 

Aretha (Frontier) 

Java 

NetPhone 
Netscape Defrosi 
Open Dorn Networks 
Web Arranger 
Free World Dialup 
Remote Printing FAQ 


Latest Updates 


http ://www. hotwired. com/staff /userta nd/a retha/ 

http://java.sun.com/ _ 

http://www, emag ic.com/ 

http://cygnus. rsabbs .com/ - ssykes/nsdefrost htm I 

http://www.opendoor. com/ 

h it p://www cesoft. com/we barranger/webarra nger. html 

h i t p;//www. pu i ve r .com/fwd / 

hTTp://finiix t ba 11 i o L ox .ac.uk/fax/faxfaq ht ml 


New Technologies 

Linux for PPC http://libeLStantord.edu/iirLrxppc/ 

Other Programmer Resources 

Application Generators http://tofgD.astrD.uda.edu/Mac.html 


Vendors, Products and Miscellaneous 

h ttp://www.altu ra.com/ 
h tip: //www .cesoft .com/ 


Aitura Software 
CE Software 
Computer Literacy 
Cyber ian Outpost 
Mad entral 
Macro Me d i a 
Mobil is 

Onyx Technology 


h ttp://www .d books.com/ 
h ttp://www cybou t. com/cy be ri an. htm I 
h rtp://www. atcon. com/maccentra I/home .html 
h ap://www m acromedia com/ 
h ttp^/www .voikswar e, com/mobil is/ 
h I lp://www.std.com/onyxtech/ 


Highlights 

Internet 

CE Software has introduced WebArranger. It is based on 
the Arrange software (demonstrated at the WWDC several years 
ago, to much applause) which CE recently acquired. Resides 
providing a database for your bookmarks, it has the capability 
to check bookmarks to see if they have changed, and notify 
you if they have. It also tracks sites you have visited, making a 
history log, which helps when you have Forgotten how you got 
to some site. 

W ebArrange r http ;//www xesoft.com/weba rranger/webarra eg er. htm I 


Unless you have been off on some remote island 
developing the perfect application, you have heard of Java and 
seen all of the media hype. If you want to find out more about 
this language, browser technology, elixir of life, killer of 
Microsoft, go straight to die source. 

Java http://java, sun.com/ 


l don’t know about you, but I have had Netscape freeze up 
my Macintosh. Scott Sykes found a problem that appears to be 
a Macintosh problem, but is actually caused by Netscape, He 
made an extension to work around the bug. Perhaps it wilt be 
fixed by the time you read this, but you might still want to 
check out his page, 

Netscape Defrost http://cygirus.rsabbs.com/-ssykes/nsdefrost.html 

Free World Dialup is trying an experiment to provide free 
long distance calling. Based on the idea provided by programs 
such as VocalTec's Internet Phone, FWD is connecting the Internet 
Ixick into the normal phone system. Servers are provided that 
will place calls in their local (i.e. free) calling area. So, if you 
want to call someone in Haris and there is a server there, you can 
do so - for free. These guys are looking for some help to 
develop a Macintosh client. If you like the idea, contact them. 
This concept is similar to the “Remote Printing” or e-mail-to-fax 
system that is also running experimentally. Check them both out 
fur some ideas on grass root services through the Internet. 

Free Wo r I d D i a I up http://www, pu Ive r. com/f wd/ 

Remote Priming FAQ http://l inuxt.ba II ioLox.ac„uk/fax/fa xfaq.html 

Macintosh 

Frank Ilennquez has put together a page discussing 
Application Generators and Application Frameworks, as well as 
providing links to some available on the Internet, Application 
generators allow you to draw an interface and then the program 
generates an application shell for you to fill in. Frameworks are 
skeletal programs that you fill in with code to do what you 
want. Sometimes you can use Ixjth together. Check out his 
page and maybe you can simplify your development. 

Application Generators http://torgo.astro.ucla,edu/Mac,htmI 

If you have ever lacked reading material, or needed to find 
some technical book, this site is for you, Computer Literacy has 
one of the largest selections of computer books, reference 
material and anything computer related. They also review 
new books, have galleys of books not yet in print, and provide 
access to their book database. A very good reference even if 
you are not near one of their stores. 

Computer literacy http://www.dbooks.com/ 

Mobilis is an on-line magazine targeted at mobile computer 
users. It primary deals with PDA class machines, but also deals 
with Issues of interest to users of any mobile computers. It will be 
especially attractive to you if you are into hand-held computers. 

M obi I i s http ://www. vo Iks ware. com / mob i I hi 
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Neat Non-Macintosh Site of the Month 

Apple and Adobe have sponsored a very hip weekly on¬ 
line magazine called SALON, It looks to be the Internet’s 
answer to the New Yorker, but hipper. The last couple of Issues 
I have read have been great. 1 could even see it make the 
reverse jump to a print magazine. 

SALON http://www.sa I on 1999.com/ 

Lombard is a brokerage house, but they are providing 
stock quotes as well. In addition, they are providing historical 
graphs for any stock of interest. Their one requirement is that 
you register your name with them (no fee involved). 

Lombard http://www.lombard.com/ 


OOFILE 


PowerPlant 

integrated closer than any other database 

AppMaker 

complete database application generation 


HTML 

report-writer built into database 


Well, Lhal is it for this month. As always, if you find 
something interesting, or have updates, send them to 
URLs@MacTedixom 

Thanks this month to Michael D. Crawford, Frank Henriquez, 
david hirtnes, Devon Hubbard, Scott Sykes, Chris Wysocki, Jordan 
Zimmerman, and many others for their contributions for their 
suggestions and pointers to new and old sites. 


No Stream Methods 
No Preprocessor 
No Fuss 

tlenrC^ high way 1 .com.au 
CompuServe: 100033, 324 1 
http://www, highway 1 .com.au/adsohwarc/ 

demo's on CodcWarrior &c AppMaker CDY 
royalty-free, full source, priced from $900 inc* c-rrec 


the cross-platform OODBMS that speaks C+ + ” 


Get Your Name “In Lights” 


Here at MacTcch Magazine t we rely heavily on outside writers 
for most of the material that appears In our pages If readers did 
not participate in the magazine, sending us their ideas and La king 
the time to write articles, there would be no MacTecb. We like to 
ihink of MacTecb as an ongoing dialogue amongst members of the 
Mac programming world: we facilitate the discussion, but it s the 
readers who carry it on, by responding to what they lead and to 
their own programming experiences and interests, in writing. 
Sometimes we know r that we need something specific covered, 
and we approach someone to write an article on that subject; and 
we do write a few columns in-house each month. But it is reader 
contributions, in the form of letters, dps, and especially articles, 
that give the magazine its relevance, its character, and its appeal. 

So MacTecb Magazine is not a staff of writers sending a 
constant stream of one-way messages outwards; it's a living, 
evolving network of readers conversing with one another, 
educating one another, sharing their knowledge, their experience, 
their interest, their trials and tribulations and joys and successes in 
the constantly unfolding story of programming the Macintosh. 
MacTecb Magazine doesn't just happen: ifs what the community 
makes it. If we carry reports of future trends and technologies, if 
we teach useful methods, if we review new books and tools, if we 
provoke thought, provide help, ride the wave of current interests 
and concerns, it is only because we reflect the thoughts of our 
readers, who speak through our pages. 

You are invited to involve yourself in liiLs exciting conversation 
amongst readers. You may l>e working at the cutting edge of 
programming technology, as part of a heavily funded professional 


developer effort; you may lx.* a lone hobbyist wrestling to create 
shareware for the sheer love of it. You may have been programming 
die Mac since its inception; you may have just switched over from 
Windows or Unix. You may work in C or C++ or Pascal or 
AppleScript, from scratch or in a framework. You may write big 
apps, small apps r custom solutions, extensions, code segments, for 
profit, for fun, for education, to solve one problem once. No matter 
who you are, no matter what your credentials may Ixc if you have a 
tale to tell, a trick to share, a technique to teach, we want you to 
consider joining the family of those who write for MacTedh 

Don’t just wait for a topic to !x h covered it; MacTecb / Don't 
just wish some technique would be explained better! Take 
responsibility! Write us an article yourself! 

To write for MacTecb^ just send for our Writer's Kit. Ifs a 
Microsoft Word hie containing the Styles you need to use, and 
giving lots of helpful advice and information, including all the legal 
stuff. You can let us know what you're writing about, if you want 
suggestions or feedback; this is helpful to us, because it lets us 
plan for the future. Or if you want to, you can just write the article 
and spring it on us when ifs done. If we publish your article, 
you'll be paid for it! 

Write to me, Matt Neuburg, at managing_ed@maclech.com (or 
one of the other editorial addresses listed on page 2 of the 
magazine). Ask me lor a Writer's Kit! Send me an article! Get 
published! Make money! See your name in print up (here 
alongside the famous denizens of MacTecbf 
And, most important, rake the future of 
MacTecb Magazine into your own hands! 


I'ftifu mwtr* J. 

*f€£J5IV 
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BUILD UPDATERS 
WITHOUT PROGRAMMING! 


Tips & Tidbits continued from page 88 


PatchMs Pro 

Patch'Works Pro has many options, but only one function: to 
create small, stand-alone Updater Applications which field- 
upgrade your products to newer versions* * Updaters can t>c 
freely and safely distributed online, since they are only of use to 
end-users who've already purchased your software* 

UPDATERS ARE FAST, 

SAFE & EASY FOR EIUD-USERS 

Your end-user just downloads and runs the Updater The 
Updater prompts the user for the original software via a ‘‘Get 
File 1 " dialog box (if not in the same folder as the Updater)* 

When the user clicks the "Update" button, the original software 
is updated immediately. 



! M§f lhfrnhllA.hr 1 1 

I 

IferdullHlHIft [«»,.»_ i 
P(0 [ UpgaleTHT ""! 

t ** (ivy JiVe ... ] 

util uve V.r > t.it Haunter ; 

- 1 fe;: .. ...I 

E'UUmt - Ominu '- 1.0 


Noiijc 

iHtd wi-n |Vpecnq -1 


|Smtic whiniiff ^ ] 


[soni'C m oboi'e -r 1 


Stipi^ n% iiliune w 


VI uMLine*" 


□I 


fcttMfliki. *0 iria 

(Hurt n«tr 


ftlote iiaichVd V| ( tticrkiumT.7.') 


pi i n ng; [Vi'i} hujti 4* 

uter In ter oi man 


<!) Create neto pouter 
O Hi'r ijn IftlO 
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fell Build Updater 


UPDATERS ARE CREATED IN MINUTES! 

Why tie-up valuable programming time building updater 
applications? Just fill in a dialog, and PatchWorks docs the rest! 
Since there's no coding or scripting, no bugs are introduced. 

* Works with apps, INITs, edevs, fonts, drivers, etc. 

* Works on resource and/or data forks 

* Full support for ftnverPC and fat binaries 

* Updaters support multiple "old versions" 

* Preserves personalization data (name, serial # ( etc*} 

* Customizable end-user interface 

* Updaters can execute custom CODE resources 
■ intelligent diff-mg produces small Updaters 

* Distribution of Updaters is unrestricted and royalty-free! 

NOW AN INDUSTRY STANDARD 
AFTER FOUR YEARS ON THE MARKET 

PatehWorks Pro is used by Macintosh publishers such as: 

Apple Computer, Adt>bc Systems, MacroMind, Now Software, 
Symantec, WordPerfect, and many more. Pricing begins at $ 195- 
Download a fully-fimcrional trial version from our web site: 
"httf)://wTvw*broadcastsoft.com", or call us at (407) 24143308. 


Broadcast 


Broadcast Software Corp 

East: 407-2410308, Fax: 407-241-3195 
West: 503-31743429, Fax: 503317-0430 
Net: lutpyMvwhioadcastsoftcom 
Email; in fo@boatlcastsoft.com 


or die next line should read: 

GetDItem £theDialog. i + 1. MType. fciHandle. &iReet): 

Tins error Ls a little hard to detect. Calling GetDItem with 
ileniNo set to 0 doesn't cause any harm. The only effect thi*s 
bug has is the final entry in the D1TL isn’t included in the 
search. This final item usually isn’t a push button, so the author 
didn't notice the error in his own routine. Otherwise, this code 
works wonderfully; I use a repaired version all the time! 

Mike Trent 


A Moke General Contfat Sensitive Cursor 

In Lhe December issue of MacTedi, a technique for making 
your application WindowShade sawy was presented, which 
checked the current content region of the window to see if it 
was null. A more general method for setting the cursor, which 
works for WindowShade as well as handling the cases of the 
cursor outside of the window and when the cursor is in a 
floating window over the active window is: 

GetMouseUmouseLoc) ; 

if (!PtInRgn{nio!i£eLot! ,theWi ndov->vi fiRgn)) 

// tfieWindow is the current window 

t 

if Cursor is not in visible region of the window 

// Set cursor lo default arrow 
InitCursor0: 

I 

else 

f 

// Adjust the cursor to the proper shape 

1 


Paul Hyman 



To receive information 
on any products 
advertised in this Issue, 
send your request 
via Internet: 

productinfo@xplain.com 
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Gilbert by Scott Adams 


DRESSING FOR SUCCESS 

HEN'S BUSINESS CIOTHES 


ft HAN'S BUSINESS 
CLOTHES ARE THE HOST 
IMPORTANT DETERMINANT 
OF HOU HE IS TREATED. 



THESE CLOTHES SAT *1 WILL BE 
ft 6WWY CLERK FOREVER. TREAT 
ME LIKE EAR UAH." 



THESE CLOTHES SAY ‘I AH BOUND 
FOR HANA6EMENT. PRETEND YDU 
LIRE HE BECAUSE I COULD BE 
TOUR BOSS SOMEDAY." 




SOLID SOLUTION FOR 
ELECTRONIC DISTRIBUTION 


Broadcast 

Broadcast is a highly secure, patent-pending system for safely 
distributing "locked 1 " software online, or on CD-ROM. til is 
cutting-edge technology was developed by the same 
engineering team behind PatchWorks— our tool for creating 
online updaters that's become an industry standard used by 
clients like Apple Computer, Adobe Systems, MacroMind, Now 


. “ Software 
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BROADCAST IS EASY 
FOR YOU AND YOUR CUSTOMERS 

In seconds, Broadcast securely locks your product into an 
Unlocker application that can be safely distributed to the 
public, lb buy your product, customers simply run the 
Unlocker— then either call you, or complete an onscreen order 
form that's emailed or faxed to you with a unique "control 
number' 1 (and encrypted credit card data). 

Your staff processes the credit card, registers your new user, 
and provides your customer with a password based upon the 
control number. To unlock your software, the customer enters 
this password in the Unlocket 

BROADCAST IS INEXPENSIVE 

Wc aren't resellers or distributors. Customers buy directly from 
you, and we take no percentage of your sales— just a small fee 
per transaction. In fact, Broadcast is distributed for free. Wre 
betting you’ll quickly use the free password points that come 
with Broadcast, and purchase more as your sales soar. 

Well even help attract customers by advertising your products 
for free on our “Software Unboxed” internet mall 

GET THE WHOLE STORY 

We invite you to learn more by visiting our internet web site at 
H http://w r w , w.broadcastsoft .corn", and download your free 
Broadcast Starter Kit, or email us: “info@broadcastsofLCom n , 


Broadcast 


Broadcast Software Coip 

Last: 407-2414)308, Pax: 407-241 -3195 
West: 503*3174M29, Fax: 503-3174)430 
Nci: hit p y/www.bit»tlcastsoft .com 
I:: \ iai I: info@bitjaefcasis«ift.com 


February 1996 • MacTech Magazine 


Tips & Tidbits 


































































MacRegistry™ |j j) 

Developer Job Opportunities 

If you arc a Macintosh developer* you should register with 
us! We have a database that enables us to let you know about 
job Opportunities. When we are asked to do a search by a 
client company the database is the first place we go. There 
is no charge for registering. The database service is free. 
Geographic Coverage is nationwide* 

Marketability Assessment - To get a specific feet for your 
marketability send a resume via Email or cal L You may also 
request a Resume Workbook & Career Planner. 

Discreet - We arc very careful to protect the confidentiality 
of a currently employed developer. 


Scientific Placement is managed by graduate engineers, we 
enjoy a reputation for competent & professional job place¬ 
ment services and we arc Mac fanatics* 

1-800-231-592(1 * das@spi.com * Fax 1-800-757-9003 
ht tp://w w w .sci e ntific.com 


Scientific Placement, Inc. 


v 


MT, Box I WW. Houston, TX 11224 . 713-49^6100 Tux: 7 3 

MT,B™ 71, San Ramon, CA 94m 510 733-6168 ficih« 4 pka.WLct)m 

MT, Box 20267*. Austin. TX 78720-2676 512-260-0123 ltj@zilker.rKi 

MT, Ken more SmiHin, Box 15225, Boston, MA022I5 617 424 8372 jcn^pbm.ph.t-am 

Apple!.ink: DI3$ft CompuServe: 71250,3001; eWorld; sfri: AOL; davesinalI 


J 





ITHATT!\IER NETWORK 


COMPUTER CONSULTING SERVICES 

T he Trattner Network (TIN) is looking for experienced 

Macintosh developers for culling edge opportunities in Northern 
California and across the country. 

T TN represents clients whose projects tor consulting and FulJ 
Time Employment include development in OpenDoc, 
Cyberdog, Copland* Newton, PowerPC, Metrowerks, 
MacApp, and many others 

^ GW — The Trattner Network has urgent needs for: 

* Software Developers * Hardware/Firmware Engineers 

* QA/QC Professionals • Project Coord in atorf Managers 

• Multimedia Developers * Network Professionals 

The Trattner Network l ias a unique history in Mac consulting 
coupled with exposure to emerging technologies. If you are looking 
for a chance to enhance your skills and marketability, 

please send* fax, or link your resume to: 

The Trattner Network 

Attn: Emily Hoothorsl 

170 State Street. Suite 240 * Los Altos, CA 94022 
Phone: 415*949*9555 ext 115; Fax: 415*949*1026 
AppleLink: trai.net; E-mail: emily@tratncl.com 

THE DIGITAL TALENT SOURCE 


MACINTOSH SERVICES 


Publish Your 
Software Free 

United Software Exchange 
will market your software 
nationally at no cost to you. 

Interested? Tor no obligation 
information email Ralph at 

USoftEx@ aol.com or 
call (708) 582-7465 


■+'*+■ 

U S E 

United Sofiwa re Exchange 


"I can do anything with C++ 
and a good pair of socks." 

_*. ■ 

- MacXpert* 
Programmer 
approaching 
Himalayan village 
at 20,00ft tact. 

Macintosh Programmers 
& Adventurers Wanted 

IVlacKperts is a software 
development company with 
immediate openings for Macintosh 
programmers with C H C++, or cither 
Mac programming experience. 

Take the first step to ad vent ut*. 
Call Michael Ruttie at: 

1 - 8 D 0 - 356 -SM 0 or fart /m 3583 M 7 
Internet; *pem<?JnN.net 
Applet i it It, Xpert* AOL: M a experts 

kttp;//w*w.ma(xperts.com/-xperts 


MindVision Software 

(co-authnrc of Speed Doubler) 

wants to pay yon well, 

insure you and your family, 
give you lots of vacation time, 
great equipment to work on, 
great people to work with, 
listen to your ideas, 
and help gel your name in 
the 

credits of some of the 
most successful products in 
Mac & PC history. 

W ask only that you try as 

hard 

for us as we will try for you! 
If you warn lo team up with a 
great software company 


MacTech Magazine 
is your 

recruitment vehicle 

When you need to nil 
important positions at your 
company, MacTech Magazine 
is the consistent choice of 
companies across the country 
for hiring the best qualified 
Macintosh programmers and 
developers. Let MacTech 
Magazine deliver your recruit¬ 
ment message to an audience 
of over 27,000 qualified 
computer professionals. 

Cali Ruth Subrin at 
805/494-9707 
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Westwood Studios has 
openings for talented 
Macintosh Programmers 
to work in-house. If you 
have 3 years experience 
coding C/C++ on the 
Macintosh, we’d like to 
hear from you* 

We are currently 
celebrating our 10th year 
of leading-edge games 
development. Our most 
recent hits include 


Command & Conquer, 
Monopoly, The Lion 
King, Dune II, and The 
Legend of Kyrandia* 

We offer competitive 
salary and bonuses, an 
excellent benefits package 
and a challenging work 
environment* A move to 
Las Vegas means no 
state income tax, 
affordable housing and 
outstanding scenery* 


i i ’wmmm 


HP 


For confidential consideration 
please send your resume Attn: Elsbeth 
Westwood Studios 
5333 #* Arville t Suite 104 
Las Vegas t Nevada 89US 
fax (702) 368-0677 • phone (702) 368-4850 
email careers@westwood.com 
website http://www.westwoad.com 


“YOUR RECRUITMENT 
ADHERE* 


Make direct contact with over 30,000 
Macintosh programmers and developers 
by placing a low cost classified recruitment 
ad in MacTech Magazine’s career 
opportunites section, The Classifieds. 
Whether pub set or your display ad, this is 
the direct approach to Macintosh 
programmers and developers. 

For more information 
about placing your ad, 
call Ruth Subrin at 805/49+9797. 


INNOVATION /INACTION 


Jam the team building Medio UXXR), the stote of-the art 
Macintosh video editing and post-production system 

We have multiple openings for Software Engineers and 
Senior Software Engineers. Strong C/C++ and Macintosh 
skills, and experience working as parr of a close knit team 
are essential Also experience in one or more of real time 
and embedded systems, device drivers, MacApp, PoworPlant, 
TCL, QuickTime, or video/audio post product nut technology. 
BSCS and 5 years* experience preferred. 

We also have multiple openings for Quality Assurance 
Engineers and Senior Quality Assurance Engineers. 
Minimum of 2-3 years' QA experience required, along w ith 
experience in multimedia, video, or graphics. (loud commu¬ 
nication skills and ability to write test documentation 
essential. BSCS or equivalent preferred. 

You can expect recognition tor your insight and rewards for 
your dedication here, as weit as a competitive salary and total 
benefits package. including an on-site fitness center and a 
smoke-free environment Please send your resume r including 
satary requirements . to: Peter Heffemon, Data Translation. 

100 Locke Drive, Marlboro , MA 01752: or FAX to (508) 481-8620 
or e-mail to pheffemanWATX.COM. We believe in equal 
opportunity and quality at every level of our business 


DATA TRANSLATION 























NEWSBITS 


By John Kawakami, MacTecb Magazine Editorial Assistant 



Dyian Pre-release Ships 

The Apple Dylan Technology Release is a development 
environment for the Macintosh platform based on an Object- 
Oriented Dynamic Language (OODL) called Dylan, 'Hie goal of 
this release is to provide developers with rhe opportunity to 
familiarize themselves with Dylan as a language as well as Apple 
Dylan as a development experience* It is being offered to 
encourage exploration of the Dylan language and environment. 

This is a “Technology Release" because the software is 
unfinished* It contains a number of bugs, and will not be 
supported or updated through Apple’s standard technical 
support processes* 

Applications under development can be run on any 
Macintosh and will run native on the PowerPC* The 
development environment itself runs best on a (>8030 or 68040 
based Macintosh with at least 20 megabytes of physical memory. 
For Power Macs, developers should turn off the Modem Memory 
Manager to run the development environment in emulation, 
Apple Dylan has been tested on MacOS versions 7/1 and 7.5. 

The Apple Dylan Technology Release includes: 

• Dylan compiler and runtime 

■ Integrated development environment featuring incremental 
development and advanced configurable browsing and 
viewing of code 

■ Dylan application framework 

• Dylan user-interface builder 

• Cross language support allowing seamless access to existing 
C code and APIs 

• Complete printed documentation 

The Apple Dylan Technology Release is hosted on 68K- 
based Macintosh systems. However, you will be able to 
produce applications targeting both the 680x0 and Power 
Macintosh systems. 

Tire development environment lets you create projects with 
all the advantages of a rapid-prototyping environment. Your 
project ts stored in a database rather than in text files. 
Customizable browsers let you explore and edit your program 
from a number of jXTspectives. For example, you can browse 
class hierarchies graphically, find all callers of a given function, 
or find all the objects which reference a given object. 

The incremental compiler allows you to change code in a 
running program and see the results immediately. This gives 
you freedom as a programmer to explore various options anti 
rapidly improve your software* 


Tine Dylan language is thoroughly object-oriented and contains 
a number of features which encourage abstraction, leading to 
cleaner, more maintainable code. Automatic memory management 
frees you from the burden of manually allocating, tracking, and 
deallocating memory usage in your application, saving you both 
programming and debugging time. The language’s consistency and 
familiar syntax ensure that it is easy to leam, 

Apple is in active discussions with various partners 
exploring ways to enhance die technology release in the future. 
Any future versions of rhe technology release depend on the 
successful completion of those discussions. 

Orders can be placed to A PDA; use order * M4724Z/A* 
The price is $39*95* To order from North America, please call 
the appropriate toll-free number: 

United Stales 1 (800) 282-2732 

Canada 1 (800) 637-0029 

Other international customers may order by contacting one 
of our licensed resellers in 30 countries, or by calling the 
following number: 

1 niernatlonal (716) 871-6555 


Symantec Releases Java DevelopmentTools 
Symantec Corporation announced it has licensed the Java 
Internet programming language technology from Sun 
Microsystems and released the first java development 
environment for Windows 95 and NT, code named ‘‘Espresso". 
Espresso is Symantec’s fully integrated development 
environment which seamlessly incorporates Sun’s Java 
Development Kit (JDK) for the creation of Java applets for 
Internet web pages. Espresso provides Java developers with 
class and project management capabilities within a graphical 
development environment. 

Espresso parses die Java Source code on the fly and creates 
a repository of information about Lhe Java applet and the Java 
class libraries. This provides a visual representation of the Java 
application class hierarchy, allowing the user to better 
understand the standard Java classes, as well as classes of the 
application. The Class Browser allows developers to browse 
Lhe java sources as well as giving them the ability to browse 
and edit methods* data, and classes* The Class Browser also 
allows developers to work with the object-oriented pieces of 
their Java program* as opposed to source files* 

Espresso for lhe Power Macintosh development 
environment will follow in the first quarter of 1996. 
http://su n we b* sy m a ntec. com: 80/1 it/de v/java index, h tm I 
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Language Systems and Spyglass Merge 
to Form Fortner Research 

Language Systems, makers of IS FORTRAN and LS Object 
Pascal, Imve merged with Spyglass Inc. r makers of advanced 
data visualization software, to form Fortner Research. 

Bond Fortner, Ph.D*, the Spyglass co-founder responsible 
for technical product marketing of its visual data analysis (VIM) 
tools, is charting the company's course ;ts ehalnnan of Fortner 
Research. Joining him from language Systems are Rich Norling, 
that company’s founder, and Guy McCarthy, who retains his 
tides as president and chief executive officer in the new 
company. Spyglass, lnc. t elected to sell the visualization 
software to concentrate on developing communications 
products for the World Wide Web. The Language Systems 
product line includes LS FORTRAN and LS Object Pascal 
compilers, and Math 77, a crass-platform library for numerical 
computation. 

The new- company will maintain current pricing for both 
product lines. Fortner Research expects to introduce significant 
upgrades of existing products in 1996, In addition, it is actively 
investigating new data technologies emerging from the world of 
supercomputers. “We're going to deliver new' levels of 
performance and capability that exceed everything we have 
today," McCarthy predicted. 

LS Object Pascal, which recently became a drop-in 
compiler in the Symantec IDE, will continue to be supported 
and developed by Fortner Research. 

Former Research LLC. T 100 Carpenter Dr.. Sterling, VA 
20164. Phone: (703) 478-0181; fax: (703) 689-9535. 
http://wwwJangsys.com/langsys/ 
info@fortner.com 


It Takes Three to Tango 
(Tango, Hitler, WerSTAR) 

EveryWare has begun shipping Tango, a full-featured visual 
development tf>ol that integrates databases with Web servers. 
Tango lets Web administrators create Web pages that utilize 
databases without writing any SQL or HTML axle. 

Tango connects WebSTAR to Every Ware's Butler SQL 
relational database server. An ODBC version of Butler Ls slated 
for release in January of ’96, Tango provides the tools allowing 
webmasters to create: 

• electronic shopping malls 

■ product and pricing catalogs 

• chat and conferencing systems 

• event registration systems 

• enhanced security systems 

Tango's approachable visual programming environment 
increases productivity and allows non-programmers to develop 
applications for the Web. Webmasters can focus on the 
graphical and layout elements of the solution while Tango 
handles the database elements. In addition to the standard 
editing environment. Tango also lias Query Builders, which are 


like assistants or guides. They allow quick creation of search* 
insert, update and delete interfaces to die databases. 

Every Ware Development Corp., 7145 West Credit Ave, 
Building l t Stc\ 2. Mississauga, Ontario, Canada I.5N 6J7. 
Phone: (905) 819-1173; fax: (905) 819 1172; FirstClass BBS: 
(905) 819-9891. 

htlp://www.everyware.com/ 

info@everyware.com 


NetForms Advances MaxumIs Quest 
to Make Your CGIs Obsolete 

NetForms is an add-on application which runs on your 
MacHTTP WWW server. It allows forms entered by users of 
the server to be automatically converted to formatted HTML 
documents, which can then l>e read by other Web clients. In 
addition to these expected features, NetForms will automatically 
add links to specified strings (like your name) and 
automatically manage large lists of pointers to other documents. 
The price for a single server is $195, and the educational price 
for a single server is $95. 

http://www.maxum.com/NetForms/ 


Objectivity Announces Objectjatty/DB 
Server for Macintosh 

Objectivity, Inc. announced a Macintosh server for 
Object!vily/OB, the scalable, high-availability, high-performance 
object database built on a fully distributed architecture. The 
new Objectivity/DR server for Macintosh incorporates 
administrative tools with a native Macintosh look and feel, 
bringing Macintosh peer-to-peer server capabilities in a 
distributed network of object-oriented information servers. 

"Macintosh usability combined with the robustness and 
scalability of Objectivity's object database will make ii easier for 
developers to build more sophisticated object-oriented 
applications, such as video-on-demand t for their customers," 
said Mike Zivkovic, business development manager for Apple 
Computer's Development Tools Group. 

Objectivity/DB supports development language interfaces 
for C++ and Parti 1 lace Smalltalk, as well as ANSI-standard SQL 
with ODBC support for integrating applications with off-the- 
shelf tools. Objectivity/DB objects are interoperable between 
language interfaces - for example, an object created with C++ 
on one platform can be read, updated nr deleted using 
Smalltalk on another platform. 

The Objectivity/DB server for Macintosh will be available 
beginning in the first quarter of 1996. North American pricing 
for the Objectivity/DB server for Macintosh begins at $155 per 
single user. 

Objectivity. In the US, phone: 415-254-7100; in Europe, 
phone: +31 1045 83986 

http://www.objeaivity.com ^ 

info@objy.com » 
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Learn C on The Macintosh 
Second Edition By Davo^l# 

Ma^k: Leam C on The Macintosh Second 
Edition: This is a completely revised 
edition of Learn C on The Macintosh With 
this sell-teaching, easy-to-understand 
book and the enclosed CD-Ronn, you get 
everylhing you need lo start programming 
in this widely used language Mew to this 
edition are updated and enhanced 
exercises that lead you step by step 
through the programming fundamentals 
and C language basics including function, 
variables, pointers datatypes, data 
structures, and Ihe file input and output 
Also new Is completely rewritten code, 
plus answers and source code lor all of Ihe 
exercises The new CD-ROM with 
Metrowerks Code Warrior™ Lite, a special 
version ot one of the hottest Macintosh 
programming environments, (including a 
PowerPC version). SM $31.45 

Tricks of The Mac Game/^ 
Programming Gurus is the 

ultimate resource lor beginning to expert 
game programmers who already have 
general programming experience. Complete 
overview of ail the necessary component ol 
game programming on the Macintosh. 
Hundreds of tips, tricks, and insider secrets 
from Mac game programming experts on a 
CD-ROM, packed wilh valuable tools, 
utilities, sample code. Code Warrior™ Lite 
and game demos. Coverage of cutting-edge 
topics such as QuickDraw 30 and Power 
Mac optimization and inside info on how 
Glypha III was created Unique in the 


marketplace - no other Mac game 
programming book is (his complete! The 
book contains instruction, tips, and source 
code from the fop names in Mac game 
development today, The secrets, examples, 
and code can! be found anywhere else! 
These are the tried-andHrue tricks that work 
behind Ihe scenes in the most popular 
commercial and shareware Mac games 
Throughout the hook, youll find special 
interviews with some ot Ihe most well -known 
Mac game programmers, They reveal their 
secret solulions created while Ihey developed 
their popular games $ 45.00 

O0FILE is the first OODBMS 
framework to offer a complete 
solution lor application authors 
Replaceable backend database, currently 
Fairconfs c-tree Plus For cross-platform 
royalty-free power PowerPlanl and other 
frameworks integrated with edit fields, 
database browsers & more. AppMaker 
users, generate complete applications 
User-friendly syntax makes it easier to 
migrate from FoxPro and the non-00 
world. Demos on CodeWarrior and 
AppMaker CD's $900 tor a once-otf c- 
tree bundle, or $1,095 1-year 
subscriptinmHIML and character mode 
report-writer $195. Full GUI report writer, 
including HTML, is $495. Mac Platform 
Bundle - includes atl Mac frameworks, c- 
tree. and Report-Writer $1,495 

PowerTap accelerates soft /j^ 
ware by lapping info msjlIipleTjjy 
processors. Version 3.0 laps into 


networked Macs and all processors found 
in the new multi-processor Macs 
Developers can speed up their 
applications without having lo learn about 
networking, communications and task 
scheduling algorithms. The PowerTap™ 
library has the easiest API - it behaves as 
a simple black box where tasks are 
submitted and results retrieved Full error 
recovery is built-in. so your job will 
complete no matter what. PowerTapte 
advanced scheduling algorithms ensure 
oplimai assignments and the fastest 
execution possible. 11 is compatible with 
all Macintosh hardware, software and 
major compilers. Version 1 comes with 2 
remotes - $1200 Version 2 comes with 5 
remotes -ST900 Version 3 comes with 
unlimited remotes $2700 

Roaster DR1 “ Be the first/w 
Macintosh developer on ypurHpifr 
block to take advantage ol Ihe unique 
capabilities of Sun's™ new Java™ 
Programming Language! Developer 
Release 1 of Roaster™, new from Natural 
Intelligence, Inc , is the first ever 
developmen! environment for writing, 
testing, and running Java™ applets on the 
Macintosh Features include: fully 
integrated development environ men I - 
project window that includes a Finder-like 
view of packages lightning-fast - 
Macintosh native compiler source code 
editor with powerful search features and 
inluihve use interface - runtime engine 
for quick and easy applet testing. When 
you purchase Roaster™, you are emitted 


to; unlimited, personalized lech support 
throughout Ihe length ol your 
subscription DR l, DR 2, Roaster 1.0, and 
one additional update. Roaster™ is 
accelerated for Power Macintosh 
Requirements Macintosh or Macintosh 
compatible computer with a Motorola 
68020 or higher or Power PC processor: 
CFM-66K (for 68K machines); 8MB RAM; 
Color QuickDraw; System 7 12 or later; 
(System 7.5 or later for 68K machines): 
CD-ROM drive to install the software. 
Price: $399 Special Price: $299 

Symantec C++ is Ihe industry-standard 
Macintosh development system-and now 
(I’s native for Power Mac You can develop 
lull-featured Power Macintosh applications 
quickly and easily using revolutionary new 
features thal save time and entrance your 
productivity throughout Ihe development 
cycle Environment includes: A true native 
Power Mac implementation of the C++ 
language, including support for templates 
and multiple inheritance, MrC/MrC++ 
compilers fur fast Power Mac executable 
code (22% tester than with Ihe standard 
Symantec or Metrowerks compilers); Visual 
Architect for fast, easy GUI generation: A 
new THINK protect management system 
thal supports large, complex applications, 
nested projects, and hierarchical project 
organization: A new editor/b rowset that 
displays classes and automates many 
editing functions; A powerful, easy-to-use 
source code debugger; The industry- 
slandard THINK Class Library; Free 
subscripliorweceive the next two updates 


MACTECH MAGAZINE PRODUCTS & ORDER INFORMATION 


Rim it. Fax, write, or call us. You may use 
your VISA, MasterCard or American Express; 
or you may send check or money order fin 
US funds only); MacTech Magazine, WO. 
Ik>x 5200, Wcstkke Village, CA 91359-5200, 
Voice: 805/494-9797, Fax: 805/494-9798 

If you art 1 an e-mail user, you can place 
orders or contact customer service au 

* AppleLink: MTCUSTSVC 

■ t :< impi iScmv 71333,1063 

* Internet; rustservicedxplaiii.com 

* GEnie: MACTECHMAG 

MACTEOI WEB SITE: 
li t i p://ww w. mac tec h.co m 

For complete product info 

simscRmiom 

US Magazine: $47 for 12 issues 
Canadian.: $59 lor 12 issues 
International: $97 for 12 Issues 
US Magazine with Source Code Disk: 

S I 24 for 12 issues 


Canadian Magazine w/Souree Code Disk: 

$136 for 12 issues 

International Magazine w/Source Code Disk: 

$194 for 12 issues 

CD-ROM 

MacTech CD-ROM. Volumes 1-10 Includes 
over 1230 articles from all 115 issues 
(1981 1994) of MacTech Magazine (formerly 
MacTuior). All article text and source code* 

Now in THINK Reference format. The CD includes 
Symantec's THINK™ Reference 2.0, working 
applications with full documentation* product demos 
for developers and more See advertisement, this 
issue: $49. Upgrades $39, 

E-mail* call or write for info, 

IKX)K5 

Tfw Best of MacTUtor, Vol. 1: Sold Out 
Ihe Complete MacTuior, Vol, 2: Sold Out 
The Essential Mac Tuior, VoL 3‘ $19.95 
77 m? Definitive MacTuior, Vol, 4: $24 95 
The Best of MacTuior, Vol. 5: $34.95 
Best of*MacHUor (a>] lecik in, Volumes 3 - 5: $69 
Best of MacTuior, Volumes 6.7 r 8 & 9: 


Not available 
DISKS 

Source Code Disks: each 

Topical Index (1984-1991) on disk: $5 

MAGAZINE BACK ISSUES 

Volumes 3, 4, 5, 6, 7, 8 r 9 and ID: 

$5 each (subject to availability) 

California resklents include 8.25% sales tax 
on all software, disks ami lxx>ks. 

Allow up to 2 weeks for standard domestic 
orders* more time for intemationaJ orders. 

F1TA.SE NOTE 

Source code disks and journals from MacTech 
Magazine are licensed to the purchaser for private 
use only and arc not to lx- copied for commercial 
gain. However, the code contained therein may be 
included, if properly acknowledged, in Ooinmeraal 
products at no additional charge. All prices are 
subject to diange without notice. 
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SPECIALS • EXCLUSIVES • HOT ITEMS! 


free when you send in your registration caret 
and more! Price: $399 

Symantec C++ for 68k. allows you 
to build applications faster and easier with 
the powerful combination ol fully 
integrated visual tools and the latest In C 
and C++ compiler lech no logy. C++, now 
the standard in development languages, 
provides an object-oriented approach to 
application development, and the resulting 
code is extensible, reliable, and 
maintainable Includes: Integrated 
Environmenl with full source-code 
debugging, integrated editing and 
browsing, and resource creation and 
editing; support for standard language 
features such as temp fates and multiple 
inheritance as well as quick compile limes 
and highly optimized code: Incremental 
linker which eliminates iong link times: 
fHiNK Class Library - a mature, Cm 
based, application framework provides a 
solid foundation on which to build 
factored and scriptable applications with 
support for C++ exceptions, ruu-tinre lype 
identification, persistent objects, and 
AppleEvenls; Visual Architect™ to visually 
design your user interface and 
automatically generate complete THINK 
Class Library source code; THINK 
Inspector which provides you with quick 
and easy navigation ol your application's 
class hierarchy while it is running; Project 
Models to start new projects quickly from 
templates either provided in this package 
or created to fit your own needs; Source- 
Code Control with integration with Apple s 
SauroeServer (included) provides reliable 
version control and supports team 
programming; Support for Scripting lets 
you automate complex, multiproject 
operations using AppleScripl or Frontier 
scripting. Powerful Standard Libraries 
which includes 10 Streams, ANSI standard 
C library, and sample programs Full 
source code is included; Extensibility 
supports third-party editors, and 
AppleScript and MPW tools (available 
from Apple) and allows access to THINK 
Reference; Create applications; desk 
accessories; device drivers; and any kind 
at code resource, including HyperCard 
XCMDs and XFCNs, system extensions, 
and control panels; Migration Path to 
Power Mac - Create applications that run 
on 68K Macs and Power Macs (emulated) 
These applications can easily be migrated 
to native Power Mac, by trading up to 
Symantec C++ for Power Mac Price: $79 

Mastering the THINK 
Class Library by Richard 
Parker Now that Symantec's long-awaited 
PowerPC native compiler is hem, developers 
are taking another look al THINK. This book 
provides a thorough examination of 
Symantec's extensive Class Library and Ihe 
Visual Architect, a graphic user interface 
development tool that allows you to produce 
commercial-quality applications with a 
minimum of effort A complete description ot 
the structure and operation ol Ihe TCL 
includes explanations of all code generated 


by the Visual Architect, any necessary 
custom code, and the operation of Ihis code 
Visual Architect tutorials provide you with a 
step-by-step approach for simplifying the 
development of complex Macintosh 
applications. 496 pages £19.95 $ 26.96 

A Fragment of Your/^. 
Imagination by Joe Zobkiw.lg^ 

Here's some practical help for ereaiing 
code resources and code fragments for 
the Macintosh and Power Macintosh. 
Rather than simply gathering and 
indexing chunks of this vital code, I ha 
author provides thorough explanations lo 
teach you more about how the Macintosh 
system functions as a whole. He also 
provides hard to find information about 
techniques used to structure arid build fat. 
sale tat and accelerated code resources 
for use on both 680x0 and Power 
Macintosh All code is reusable and Is 
provided on the disc, along with 
Mehowefte Code Warrior Lite Book/CD- 
ROM. 523 pages mm $ 35,96 

Inside CodeWarrior 8: vv. 

Includes CodeWarrior IDF User's 
Guide This manual shows you how lo use 
the CodeWarrior IDE (Integrated 
*<■ „ . , 4 Development Environment). 
Jj ? - j ' It shows you how to create 
ffi- W fl software for 6QK and 
jgfev.T- PowerPC Mac OS, 

Win32/x06, and Magic Cap. 

It also shows you how lo 
use ToolServer from Ihe IDE and how to 
control the IDE using AppleScript, The 
next highlight is CW Error Messages, 
which describes Ihe errors you might 
encounter while using CodeWarrior 
compilers and linkers, this manual 
contains descriptions, source code 
examples, and fixes to these errors, as 
well as the Debugger Manual, which was 
updated for CW7 including new inline and 
exceptions debugging, and a new 
troubleshooting section. Next up is Ihe 
MPW Tools Manual, which shows you 
how lo use Metrowerks compilers, linkers, 
and other tools under the MPW Shell. 
Updated for CW7, new chapters 
comparing Metrowerks and other MPW 
tools, and then onto C, C++, and 
Assembly, and Pascal Language 
Reference, covering the Metrowerks 
implementation of C, C++, and 680x0 
assembiy language programming, 
updated for CW7. The Pascal rets also 
include the new UN SIGNED WORD and 
UNSIGNEDL0NG Also included for this 
time are Profiler and Zoneftanger Manuals 
updated forCW8. $3495 


Inside PowerPtant is the 

Power-Plant Manual, and contains 
^ f information about creating 
PowerPtant applications 
using the CodeWarrior IDE 
and PowerPlant Constructor, 
and describes major 
PowerFlanl classes and 
resources. Also included are the 
PowerPlant Constructor Manual, including 



View, TextTrails and Custom Types 
editing, and PowerPlant Library Reference, 
covering all classes and functions in 
PowerPlant, updated for CW8. $34.95 


BBEdit 3.5 from Rare Rones Software is 

I now better than ever. 
In addition to being 
Accelerated tor 
Power Macintosh, Ihis 
powerful, intuitive text editor oilers 
integrated support for THINK C 7.0, 
Metrowerks CodeWarrior 6 r THINK 



Reference 2.0 and mpw ToolServer. 
Version 3 1 adds even more capability, 
including "solt" wrapping ol text on screen 
and numerous refinements and 
improvements to the user interface. 
BBEdit's many features include: integrated 
PopupFuncs" technology for speedy 
navigation of source code tries (C. C++. 
Pascal. Rez, 6flK Assembler, and Fortran), 
unique Find Dilferences' command 
(BBEdit can find differences between 
projects and folders as well as files), 
support for Macintosh Drag and Drop for 
editing and other common tasks, 
PowerTalk support for reading, sending 
and composition of PowerTaik mall, 
scripting via any OSA compatible scripting 
language including AppleScript and 
Frontier 3.0, and fast search and replace 
wilh optional "grep" matching and multi¬ 


file searching. BBEdsfs robust feature set 
and proven performance and reliability 
make it the editor of choice tor 
professionals and hobbyists alike $99 


QC” by Onyx Technology, is a system 
extension lhat stress tests code during 
runtime for common and noLso-common 
errors. Tests include heap checks, 
purges, scrambles, handle/pointer 
validation, dispose/release checks, write 
to zero, de-reference zero as well as other 
tests like free memory invalidation and 
block bounds checking QC is extremely 
user friendly for the non technical tester 
yet offers an API tor programmers who 
want precise control over testing QC Is 
Also available in Japanese. $99.95 


FaceSpan v2 is an extensible Rapid 
Application Designer (RAD) that makes 
building applications quick and easy It 
combines an interactive, visual interface 
design environment with the object- 
oriented power at AppleScript or any OSA 
language Best cl all, FaceSpan allows 
you to integrate the capability of 
scriptabte programs into your custom 
application Your FaceSpan applications 
can include any number of windows, 
dialogs, palettes, and menus. In them, 
you can display scrolling lists, popup 
menus, scrolling text, movies, multi 
column tables, pictures, icons, buttons, 
and others While no scripting Is needed 
for standard behaviors, every item may 
have its own script. You can even 
program custom objects using Pascal or 
C Try Ihe perfect choice for MIS 
professionals, power users, consultants, 
and programmers. They T FaceSpan! 


Includes a royalty-free distribution 
license, for unlimited runtime users, ol 
yuur FaceSpan-based applications Also 
included is a FREE UPGRADE to the next 
version for registered users, $199 


Scripter- The Authoring and Development 
Environmartl for AppleScript™. Scripter, the 
Script Construction Set, is the foremost, 
comprehensive tool for creating and 
debugging AppleScript scripts. Scripter is a 
shortcut to Applescripfs full capabilities, is 
bolh powerful and easy tn use, and appeals 
equally to novices arid experts, Scripter offers 
the largest collection ol tools to answer Ihe 
needs of every AppleScripl user, containing 
over 35 features, including Superior 
vocabulary access point and click 
assembly ot commands and object 
specifications, command window lor 
expenmenlatian Shortcuts and extended 
editing capabilities - extensive drag-and- 
drop, six-function find and replace; 
navigation markers, script library collection 
facility; many otoer limesavers lor tester 
scripting Interactive debugging - 
comprehensive variable watcher, expression 
evaluation, enhanced trace log, and real 
single step debugging! Other features 
Include: integration with FaceSpan and 
background processing. Unlike other 
scripting tools, which are either tod on the 
original Script Editor concept, or are 
designed to look more like traditional 
programming tools, the designers of Scripter 
understood Iron toe oulset Ihal scripting is 
different from writing C code. Scripter will 
change the way yuu work with AppleScript 
From experl script design to user-friendly 
| editing and implementation, 
IScripter is the natural 

_|companion to AppleScript tor 

ail levetedprofioerry. %m $179 


Macintosh Programmer’s Tool¬ 
box Assistant CD-ROM - instant 
electronic access to Inside Macintosh 
essentials Now Macintosh programmers 
can gel quick access to over 4,000 
Toolbox calls that are al Ihe heart of 
Macintosh system software. The 
definitions ol these data structures, 
resources, constants, and functions are 
documented in the Inside Macintosh 
series and are essential information for 
anyone developing Macintosh software 
Macintosh Programmers Toolbox 
Assistant is a CD-ROM that harnesses the 
power of one of the best search and 
viewing engines in the industry. It allows 
programmers to access Ihe Toolbox calls 
quickly from their development 
environment. With hypertext links 
allowing programmers to view related 
topics easily Macintosh Programmer's 
Toolbox Assistanl is the ultimate 
electronic reference tool for Macintosh 
programmers $ 99.95 

Inside Macintosh: CD-ROM by 

Apple Computer, Inc, inside Macintosh is 
the essential reference for programmers, 
designers, and engineers for creating 
applications for Ihe Macintosh family of 
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computers. Inside Macintosh CD-ROM 
collects more than 25 volumes in 
electronic form, including: QuickDraw 1 ' GX 
Library. Macintosh Human interlace 
Guidelines, PowerPC System Software. 
Macintosh Toolbox Essentials and Mom 
Macintosh Toolbox. Quicklime and 
QuickTime Components. Now 
programmers will be able to access over 
16.00(1 pages of the intormalion they need 
directly Irrim their computers, Hypertext 
linking and extensive cross referencing 
across volumes allows programmers to 
search and explore ibis library in ways 
that arc unique lo the electronic medium 
Every Macintosh programmer will regard 
Inside Macintosh CD-ROM as their most 
important resource $ 99.95 

ScriptWizard 1.5 Is the latest 
version of the best-selling script- l&fy 


editing and debugging tod that combines 
the power of a professional development 
environment with the ease nt use that you 
expect ol Macintosh™ software. Compatible 
with all Apple® Open Scripting Architecture 
languages, including AppleScript™, 
ScriptWizard improves your productivity by 
delivering testing and debugging facilities 
that are as intuitive as they are powerful 
ScriptWizard makes life easier fur scripted 
by emphasizing features that speed script 
development. Some of the most significant 
enhancements to scripter productivity include 
the ability lo single-step scripts [now 
allowing true statement-level stepping), 
watch variable values as scripts execute, jump 
instantly to frequently used places in a script 
and find and replace specific text Full drag 
and drop text editing Is supported 
ScriptWizard delivers an intuitive 
development, testing and debugging 


environment tor rapid script creation with 
essential toots up-lranl for easy access $89 

CodeWarrior 8 CD by 

Melrowerks comes in two versions 
- Bronze and Gold, These CDs 
gw contain the CodeWarrior 1 
■I —JB B development environment 
wH including C++. C and Pascal 
/ #11 compilers; high speed 
sinkers; native-mode 
interactive debuggers; and a powerlul new 
application framework called PowerPlant lor 
rapid Macintosh development in Cm 
B ronze generates 680x0 code Gold 
generates both 680x0 and PowerPC code. 
Comes in two versions - Bronze and Gold 
New to these versions is an Integrated Class 
Browser Faster code. Better Code 
Generation for PowerPC Updated 
QpenDoc™ support. New Networking 


BOOKS 



Glasses In PowerPlant New Editor 
Functions Zero Overhead Exceptions for 
Cm Libraries for I he new Be Operating 
System CodeWarrior 8 Gold. With 
GodcWarrior's plug in architecture, choose 
your target platform from within one 
Integrated Development Environment. Gold 
supports the lollowing platforms: 
PowerPC™ Mac™QS. PowerTV™, Be™QS 
for BeBox™ 68K: Mac™0S, Magic Cap™ 
x86: Windows 95™, Windows NT™. It 
Includes C/C++ and Object Pascal. 
CodeWarrior 8 Bronze. Macintosh 
programming solution tfiat generates code 
that runs native on 68K and runs emulated 
on PowerPC, Supports C/C++ and Object 
Pascal Gold $399 Includes a f year 
Mar-Tech subsciption Bronze $149. 
Includes a 6-mnnth subsciption. 



Learn C on The Macintosh 
Second Edition By Dave Mark See 
page 76 

Tricks of The Mac Game 
Programming Gurus See page 76 

Macintosh G Programming 
Primer Volume I, Second 
Edition, Inside the Toolbox 
Using THINK C by Dave Mark and 
Cartwnght Reed This new edition ol this 
Macintosh programming bestseller is 
updated to include recent changes in 
Macintosh technofogy, including System 
7, new versions of THINK C and ResFdit, 
and new Macintosh machines. Readers 
will learn how lo use the resources, 
Macintosh Toolbox and interlace to create 
stand alone applications 672 pages, 
mm $24.25 

Macintosh C Programming 
Primer Volume IK Mastering the 
Toolbox Using THINK C by Dave 
Mark. Volume It picks up where Volume I 
leaves oft, covering more advanced topics 
such as: Color QuickDraw, THINK Class 
Library, TextEdit, and the Memory 
Manager. 528 pgs mm $ 24.25 

Macintosh 01E2 Programmer's 
Reference: Working With 
Objects: Provides a complete reference 
to the extensible protocol of Object 
Linking and Embedding, version 2,01 for 
Macintosh System 7 Understanding of 
C/C++ helpful, but not necessary, and 
comes wtlti a CD, Working With Objects 
describes the visual and toteraeftoe 
interfaces that support the component 
objects, provides details ol the OLE 2,01 
for the Macintosh user Interface, 
addresses the Issues of object class 
registration, shows how to implement the 
drag and drop objects from one 


application to another, covers the interlace 
that exposes the basic embedding 
functionality, and includes descriptions ol 
API functions S440& $ 40.45 

Macintosh Pascal Programming 
Primer Volume I, Inside the 
Toolbox Using THINK Pascal by 

Dave Mark and Cartwright Reed This 
tutorial shows programmers new to the 
Macintosh how to use the Toolbox, 
resources, and the Macintosh interface to 
create stand-alone applications with 
Symantec's 1HINK Pascal. 544 pages 
m&> $ 24.25 

Learn C++ on the Macintosh :ty 

Dave MaFk. After a brief refresher course 
in C. Learn C++ introduces the basic 
syntax of C++ and object programming 
Tben you'll learn how lo write, edit, aiid 
compile your first Or s programs through 
a series ol programming projects that 
build on one another as new concepts 
are introduced. Key C++ concepts such 
as derived classes, operator overloading, 
and iostream functions areal! covered in 
Dave's easy-to-follow approach. 
fncfuries a special version of Symantec 
C++ for Macintosh. Book/disk package 
with 3.5" BOOK Macintosh disk 400 
pages. mm $33.26 

Programming Primer For The 
Macintosh* Volume 1 by John 
Whittle and JiKty May. This book provides 
an introduction to Macintosh 
proqramming, using C++ as the example 
language, and provides realistic, easy to 
follow, programming examples designed lo 
work with either Symantec* C+ + or 
Metrowerter CnrieWarrinr" Also Includes 
one 3.5' disk with source code Inr the 
programming examples, along with 
numerous, useful, public domain utilities lo 
use with each compiler mm $ 34.15 


Mastering the THINK Glass 
Library by Richard Parker See page 68 

Programming in Symantec C++ 
for the Macintosh by Judy May and 
John Whittle. This book will introduce you 
to object-oriented programming, the Cm 
language, and of course Symantec C++ for 
the Macintosh. You don't have to ho a 
programmer, Dr even know anything about 
programming to benefit horn this book. 
Programming in Symantec C * + lor the 
Macintosh covers everything from the 
basics to advanced features of Symantec 
C++. If you are a Think C or Zortecb C++ 
programmer who wants to learn more 
about object-oriented programming or 
what's different about Symantec C++, 
there are chapters specifically tor you 
Includes helpful examples of C++ code 
that illustrate abject-oriented programs, 
m- £ 26.95 

Symantec C++ Programming for 
the Macintosh, Second Edition 

by Nail Rhodes & Julie McKechan is the 
perfect introduction lo C++ programming. 

mm $ 40.50 

Teach Yourself Mac G++ Pro¬ 
gramming in 21 Days by Namir 
Clemenf Shammas is the easy to follow 
21 -day format teaches readers how to 
program in C++ using the Symantec C++ 
compiler mm $ 26.99 

Writing Locaiizatrie Software 
for the Macintosh by Daniel R 
Carter, 469 pages. $26.05 $ 24,25 

Global Interface Design, 
A Guide to Designing 
International User Interfaces by 

Tony Fernandes, AP Professional Globa! 
Interface Design addresses the Issues 
involved in pm dud development for a 


global market wilh a "real world - locus. 
While covering major areas developers 
should address during the development 
cycle, Tony Fernandes provides insight 
into researching cultural differences. This 
book examines the dilfereriees found all 
over ibe wo eld. such as cultural 
symbolism and taboos, and how they 
impact user interlaces $34.05 $32.35 

Teligent's Guide to Designing 
Programs: Well-Mannered 
Object-Oriented Design in C++ 

$ 1Q 60 $17,55 Call for more 

information. 

Software By Design: Creating 
User Friendly Software by Penny 
Bauersleld (Series Editor: Tony Meadow), 
This excellent reference provides readers 
with a thorough how-to for designing 
software that is easy to learn, comfortable 
to operate and ihat inspires user 
conlidence. Written from the perspective 
of Macintosh, but compatible willi all 
platforms Stresses user input from initial 
design, through prototyping, testing and 
revision. Provides tools for analyzing user 
needs and tost responses. Includes 
exercises tor sharpening user-oriented 
design skills. M $26.95 

Macintosh Programming Tech¬ 
niques by Dan Syrtow (Scries Editor 
tony Meadow). This tutorial and 
handbook provides a thorough foundation 
in the special techniques ol Macintosh 
programming for experienced Macintosh 
programmers as well as those making the 
transition from DOS. Windows, VAX or 
UNIX. Emphasizes programming 
techniques over syntax tor better code, 
regardless of language Guides the reader 
through Macintosh memory management, 
QuickDraw, events and more, using 
sample program in C++ Disk includes an 
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interactive tutorial plus reusable C++ 
code, mm $31.95 

More Mac Programming 
Techniques: More Mac' 
Programming Techniques goes beyond the 
fundamentals of Macintosh programming 
With this hands-on guide and tutorial, 
you'll expand on ttie basic foundation ol 
programming to develop truly powerful 
applications. Inside you will lake a detailed 
look at the units oi a Macintosh program - 
from the INITs lo custom controls Along 
the way, you'll learn solid techniques you 
can apply anywhere, including tricks and 
techniques. You wifi learn tile resources 
tram the ground up, and how to build 
custom menus, add custom controls, 
including buttons, and slider controls, 
MDEF, and CDIX resources. The book will 
also help you to handle INtTs, making 
preference tiles, and haw to print lawlessly 
Irom your programs, mm $35.95 

Macworld Ultimate 
Mac Programming by HOT 

Dave Mark. Reveals the ITEM! 
secrets ol Mac programming 
and presents important, limesaving 
techniques, mm $35.95 

Mac Screamer, The Ultimate 
Macintosh* 0 Supercharging Kit by 

Jan Harrington covers 30 Macintosh models, 
including itie Classics, LCs, PowerBooks. 
and Quadras and gives software solutions 
and hardware tips to accelerate Mac 
performance. It lets readers in on do it 
yourself tips that can save them over 25% on 
upgrade costs, $35. UO $31.50 

Programming for System 7 by Gary 
Ultle and Tim Swihart, is a hands-on guide 
to creating applications tor System 7. It 
describes the new features and functions at 
the operating system in detail* Topics 
covered include file operations, cooperative 
multitasking. Balloon Help, Apple events, 
and the File Manager. Numerous working 
C code examples show programmers how 
to lake advantage ol each Of these features 
and use them in developing their 
applications. 304 pages, mm $24.25 

Guide to Macintosh System 7.5 

by DonCrabb. mm $22.50 

A Fragment of Your imagination 

byJoeZobkiw. See page 77 

How To Write Macintosh Software 

by Scott Knaster is a great source lor 
understanding Macintosh programming 
techniques, Drawing from his years ol 
experience working with programmers, Scott 
explains the mysteries and myths of 
Macintosh programming with wit and humor, 
Ttie third edition, fully revised and updated, 
covers System 7 and 32-bil developments, 
and explores such topics as how and where 
things are stored in memory; what things In 
memory can be moved around and when they 


may be moved; how to debug your 
applications with MacsBug; how to examine 
your program's code lo learn precisely what's 
going on when it runs. 448 pys. 

$26.05 

Danny Goodman’s Macintosh® 
Handbook Featuring System 7 by 

Danny Goodman with Richard Saul Wbnrm 
II includes over W spreads break down and 
clarily Mac problems and includes insider's 
lips, mm $26,05 

Real World Apple Guide, For The 

Mac is the much anticipated help and 
navigational aid component of the new Appte 
System 7 5 OS. The book is a practical 
introduction to Apple Guide for programmers, 
it explains the design and function of Apple 
Guide, how to design your own guides using 
Apple Script. Comes with a disk of sample 
Apple Guides for Apple Guide-compliant 
applications, mm $35.95, 

Danny Goodman's 
Apple Guide Starter Kit hot 

by Danny Goodman and ITEMS 
Jeremy Joan Hewes. Two 
highly respected experts offer a different 
approach for creating your own Apple Guide 
databases With Danny's Guide Starter 
program you can mate guides quickly and 
easily, without having to learn a scripting 
language, write coded fifes, or use several 
different files and programs to produce your 
database (which is what you'd have to do 
without the program). The authors provide 
advice and tips on how to design a good 
Guide, trotri planning and creation through 
testing, revising, and indexing. Book/disk, 
320 pages mm $31.46 

HyperTalk* 2.2: The Book Second 
Edition by Dan Winkler. Scott Kamlns, and 
Jeanne DeVoto is the most complete, 
authoritative source on HyperTalk 2.2 
programming and troubleshooting. It 
covers each language element of HyperTalk 
2.2 (Including the odd quirk or bug}, 
mm $3i.5o 

The Complete HyperCard 2.2 
Handbook Fourth Edition by Danny 
Goodman is the biggest-selling Mac book 
- newly revised and updated for version 
2,2, ft shows how to build working 
applications using the latest version ol 
HyperCard and covers text, painting tools, 
extension commands (XCMDs). scripting 
in HyperTalk, and more M $31.50 

Dan Shafer Presents the Power of 
Prograph CPX is a hands-on. project- 
centered approach to learning the most 
revolutionary object-oriented 
Hqt programming language on the 
ITEM! planet. The language Kurt 
Schmucker likes best. The 
language that programmers actually report 
having "fun” programming. This 550-page 
book takes you step by step through three 
inter related projects of increasing complexity. 


Aiong the way you'll learn the underlying 
Prograph language, how to use the power of 
lists, and Ihe important aspects of the CPX 
classes aod object editors. Includes disk with 
all code in the book $10.05 $44.95 
Visual Programming With 
Prograph CPX by Scott B Steinman and 
Kevin G. Carver, This is the first book on 
Prograph CPX available through the book 
trade. 11 covers the only commercially 
supported visual programming language at a 
time when many programmers and 
managers, faced with continuing productivity 
problems, are searching tor better 
programming environments. Prograph CPX 
is much more than such GUI-enhanced 
traditional languages as Visual Basic It 
literally allows you to draw your program 
flow using icons and create a complete 
application without writing a fine ol code. 
This book is ari introduction to the language 
and a guide lor advanced users, for both 
Macintosh and Windows-based machines. 
Prograph Is a fully pictorial, general purpose, 
object-oriented language that speeds 
development with an integrated environment 
tor design, coding, testing and debugging; 
with its GO framework tor sophisticated GUI 
tfevoEopmcnt; with its support for calls from 
C, C++, Pascal, and other routines; with its 
DAI, ORACLE, Sybase, AS/400 client/server 
DB support; and marry other puwerlut 
features, mm $30.60 

Graphic Gems V Edited by Alan w. 

Paelti is the newest volume in The Graphic 
Gems Series. It is intended to provide the 
grap hies community with a sot of practical 
Lools tor implementing new ideas and 
techniques, and to offer working solutions 
to real programming problems. These tools 
are written by a wide variety of graphics 
programmers from industry, academia, and 
research. The books in this series have 
become essential, time-saving tools for 
many programmers, It is the latest 
collection of graphics tips in The Graphic 
Gems Series written by the leading 
programmers in ttie field. It contains about 
50 new gems displaying the most recent 
and innovative techniques in graphics 
programming. Also included is new gems 
in ellipses, splines, Bezier curves, and ray 
tracing, includes a disk which contains 
source code from all live volumes and is 
available in both IBM and Macintosh 
versions. CONTENTS: Algebra and 
Arithmetic. Computational Geometry, 
Modeling and Transformation. Curves and 
Surfaces Ray Tracing and Radiosity. 
Halftoning and image Processing, Utilities. 

544 95 

Applied Mac Scripting 

Applied Mac Scripting covers 1 __ 
AppleScript IH , Frontier, QuicKeys, Tempo 
II, nShelJ, RoSpan Application Builder, 
Scripting PlainTalk and System 7.5. With 
this hands on tutorial Tom Trinko shows 
you how to automate your Macintosh 
activities by learning how to use the 
AppleScript and Frontier scripting 


environments. You will learn the overall 
approach to designing arid developing 
powerful scripts, and to harness the 
capabilities of a wide variety of Macintosh 
applications into the integrated 
productivity tools, This Includes such 
things as the newspaper script which 
combines the power ol Si Tea mm, 
MacWrile Pro, and Fitemaker Pro. or 
QuarkXPress, Whether you are a power 
user or experienced Mac Programmer you 
will learn valuable new techniques tor 
Mac automation, $34.95 $31.45 


AppleScript Handbook hot 

Second Ldilion by Danny HEM! 
Goodman Is a self-contained 
kit shows the reader tiow to customize and 
extend the capabilities ol any Macintosh 
computer - no programming experience 
needed! This enhanced and expanded 
edition of The Complete AppleScript 
Handbook focuses on putting AppleScript 
to work in alf sorts of practical situations. In 
addition, Danny shows you how lo apply 
the same principles to other popular 
scripting systems, such as UserLand 
Frontier and QuicKeys. Shows readers how 
to use scripts to enhance the Macintosh 
environment automate many processes, 
link data between applications, and much 
more. This book provides a wealth of all- 
new examples showing how to integrate 
AppleScript with the Finder, spreadsheets, 
desktop publishing programs, graphics 
applications, databases, telecommuni¬ 
cations programs, utilities, and HyperCard 
The accompanying 3 1/2" disk Is jam- 
packed with over $100 worth of software, 
including AppleScript 1.1, valuable 
utilities, and powerful, ruady-tu-use 
scripts mm $35,00 

The Complete AppleScript 
Handbook by Danny Goodman is a soil- 
contained kit to customizing and 
HQ! enhancing the Macintosh 
ITEM! environment. The disk contains 
AppleScript 1.1 Runtime, Chang 
Labs TableServer, and useful, rcady-to-run 
scripts. It also shows the Mac user how to 
automate many processes - no programming 
experience necessary, mm $31,50 

The Tao of AppleScript: BMUG’S 
Guide to Macintosh Scripting, 
Second Edition by Derrick Schneider Be 
Hans Hansen, This updated bestseller is a 
complete, natural introduction to AppleScript 
programming essentials. Readers learn how 
to customize applications, automate tedious 
tasks, and create programs without having to 
use a complex programming language. 2 
disks certain AppleScript, QuickTime, Sultll 
Lite. ResMover, and other heipful utilities. 
Progressive structure meets the needs ol any 
Mac user, regardless of experience. 
Professional instructions are mixed with 
practical examples for easy learning S3G.DF 
$26.95 
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BOOKS 


Wireless Far The Newton 
Software Development for 
Mobile Communications by Julie 
McKeehan and Neil Rhodes is 
HOT a book picks U P where 
ITEM! Programming for Ihe Newton 
left off. Leaching Ihe reader 
how to develop Newton® software on the 
Macintosh, The enclosed floppy disk 
provides a sample application, as well as 
a fully functional demonstration version 
ot Newton Toolkit" (NTK“), Apple 
Computer's complete development 
environment for the Newton* Gives 
hands-on Newton environment training 
with sample code created specifically lor 
the Newton*. The authors are external 
faculty at Apple Developer University 
teaching classes on programming lor the 
Newton® Programming experience is 
assumed, although not in any particular 
language. Enclosed is a floppy disk which 
contains source code for a Newton 
application, as well as demonstration 
NTfC mm $31,45 

Basic For The Newton 

Programming tor the Newton Using NS 
Basic by John Scheltino & Liz O'Hara. 
This book shows owners of Newton 
devices how to become Newton 
programmers using BASIC. The authors 
use a straight forward “programming by 
example" approach, which should have 
you writing your own Newtnn programs 
right away. It includes one 3.5" disk 
containing Demonstration NS BASIC and 
over fifty example programs Irom the 
book. It is Multi-platform in that teaches 
programming for the Newton using a 
Macintosh, a Windows-based PC, nr on 
the Newton device itself. mm $32,35 

Programming for Ihe Newton 
Software Development with 
NewtonScrlpf hy Julie McKeehan and 
Neil Rhodes. Foreword by Walter R. 
Smith. Programming for the Newton: 
Software Development with NewlonScript 
is an indispensable tool for Newton 
programmers. Readers will team how to 
develop software lor Ihe Newton on the 
Macintosh from people that developed Ihe 
course on programming the Newton for 
Apple Computer. The enclosed 3.5 h disk 
contains a sample Newton application 
from the books, as well as demonstration 
version of Newton toolkit (NTK), Apple 
Computers complete development 
environment for the Newtons A 
Publication of AP Professional May 1994. 
Paperback, 393 pp mm $26.95 

Mefrowerks CodeWarrior Pro¬ 
gramming by Dan Parks Sydow 
Includes CodeWarrior Lite, 
Hot and Full Coverage of 
ITEM! PowerPlant™ The best 
information on Metrowerks 
CodeWarrior 6, giving full coverage to the 
Gold Edition. Even it you don't already 
own CodeWarrior 6, you'll still be able to 


work with the examples in this book, 
using the CodeWarrior 6 Lite CD that 
comes with it mm $35.95 

C++ Programming With 
CodeWarrior Beginning HOT 
OOP for the Macintosh and ITEM! 
Power Macintosh by Jan L, 

Harrington from AP Professional. This 
book shows programming novices object- 
oriented programming techniques for the 
Macintosh, Power Macintosh, and Mac OS 
compatibles, using C++ as the example 
language and Metrowerks and 
CodeWarrior as the example compiler The 
enclosed CD-ROM contains example code 
Irom Ihe book and a full-function 
Melrowerks CodeWarrior compiler for 
running these examples. E M fe $32.35 

Optimizing PowerPC Code: 
Programming the PowerPC in 
Assembly Language To take full 
advantage Df the potential ot 
hot l^ e PowerPC, Developers 
ITEM! need to master the Assembly 
Language techniques. This 
book shows how to use the Assembly 
Language in PowerPC Programs to 
produce faster more robust software. 
W $35,96 

Inside CodeWarrior 9: See page 77 

Inside Power Plant: See page 77 

Power Macintosh Programming 
Starter Kit by Tom Thompson. This is 
the first tutorial/reterence for programmers 
who want lo enter the new world of the 
PowerPC chips. Users find all the details 
on the new microprocessors, the new 
RISC architecture, and how to write native 
code and emulation operations to create 
their own software for the Macintosh 
PowerPC. CD ROM includes a unique 
compiler for writing code easily. The all 
in-one book tha! gels programmers the 
information and tools they need. 
Programming examples reinforce 
explanations of code and programming 
tools »4tt $35.10 

The ResEdit All Night Diner by 

David Giskowski, An idea-Li I fed menu and 
introduction to the joys ot customizing 
software - and adding personality lo the 
Mac with ResEdit! Shows readers how to 
customize default icons, the texl of menus 
and dialog boxes, cursors, puinters, and 
more. Provides specific recipes lor doing 
creative Ihings with ResEdit - plus how to 
avoid problems. Disk features ResEdit 
program, plus lots ot sample resources 
mm $22.45 

ResEdir Complete, Second 
Edition by Peter Alley and Carolyn 
Strange. With ResEdit, Macintosh 
programmers can customize every aspect 
of their interlace form creating screen 
backgrounds and icons to customizing 


menus and dialog boxes. 600 pages. 
Book/disk package. mm $31.45 

Sad Macs, Bombs, Disasters 
and What to Do About Them by 

ted Landau comes to the rescue with your 
Macintosh problems. From fractious fonts 
lo the ominous Sad Macintosh icon, Itiis 
emergency handbook covers the whole 
range ot Macintosh problems: symptoms, 
causes, and what you can do to solve 
them 640 Pages. 42495 $22.45 

Macintosh® Crash Course by 

Glenn Brown shows Macintosh power 
users what to do when things go wrong 
with their system. Macintosh Crash 
Course shows readers how to overcome 
Macintosh syslern crashes, system lock¬ 
ups, and various, frustrating and cryptic 
error messages they regularly encounter. 
It includes a CD-ROM with shareware and 
freeware lo help the user diagnose and 
repair system failures. Includes up-to date 
coverage through Macintosh System 7.5. 
Managing memory. Hardware diagnostics. 
File recovery, PowerBook problems, 
PowerPC problems, network utilities, hard 
drive repair utilities, SCSI problems, conflicts 
and solutions and Rio synchronization and 
utilities, mm $26.95 

Multimedia Authoring: Building 
and Developing Documents by 

Scotl Fisher addresses the concerns that 
face anyone trying to create multimedia 
documents. It otters specific advice on 
when to use different kinds oi information 
architecture, discusses the human-factors 
concepts that determine how readers use 
and retain information, and them applies 
these findings to multimedia documents, 
covering the high-level issues concerning 
planners and authors of multimedia 
documents as well as those involved in 
evaluating or purchasing multimedia 
platforms, includes one 3.5" high-density 
disk, mm $31.45 

Multimedia Starter Kit for 
Macintosh by Michael D, Murie. This 
hands-on book offers the latest and 
greatest in multimedia for the Mac! 
Readers learn how to design their own 
multimedia projects step by step, then fry it 
themselves with the demos, graphres, 
clips, and sample projects on the CD- 
ROM! CD-ROM contains QuickTime, 
sound and graphics clips and utilities, 
sample projects, and more. How to choose 
arid use a variety ot Macintosh multimedia 
tools and presentation environments. 
Includes demos of Adobe Illustrator, 
Premiere, Heizer Software programs, and 
more mm $27,00 

QuickTime Starter Kit for 
Macintosh by Robert A Leltieri & 
Judith Stern. This is the ultimate package 
tor getting productive and having fun with 
Macintosh movie-making. Easy steps and 
valuable software help readers play, 


make, and edil QuickTime movies CD 
ROM includes QuickTime tools, movie 
clips, shareware, and demos ol Premiere 
and other programs. Written by members 
of the respected Berkeley Macintosh User 
Group. Tips on the best ways to bring 
live-action video to Mac multimedia 
mm $ 40.50 

3-D Starter Kit far Macintosh by 

Sean Wagstaff The complete reference lo 
3-D graphics on the Macintosh - ideal lor 
beginning to intermediate product 
designers, illustrators, graphic designers, 
multimedia developers, animators, and 
video producers, as well as architects and 
engineers! Covers more than 50 major 
Macintosh 3-D imaging software 
packages - Ihe most comprehensive book 
available. Lots of Idea-packed examples 
that illustrate how 3-D products work - 
individually and together CD-ROM 
includes sample models, image galleries, 
backgrounds, and textures, plus 3-D 
software tryout versions $36,00 

The Instant Internet Guide by 

Brenl Heslop and David Angeii. An Internet 
jump-start - how to access, use and 
navigate global networks. 224 pages 

mm $13.45 

Web Head; The Mae Guide to 
the World Wide Web by Mary jane 
Mara Published by PeachPil Press This 
is a beginning to intermediate book that 
shows you how to gel the most from the 
Web, using plain talk that beginners will 
understand, and online veterans will 
appreciate. There is also instruction on 
how to build your own home page, 
posting pages on the Web, and avoiding 
common H1 ML mistakes. $24.05 
$ 22,45 

The Underground Guide to 
Telecommuting by Woody Leonhard, 
Addison Wesley. There’s no place like 
home. Especially when your boss, your 
kid. and the neighbor's dog are all barking 
for your attention simultaneously Working 
away from a corporate office presents great 
(often unexpected) challenges and offers 
even greater rewards. Woody Leonhard 
lakes on Ihe toughest aspects ot 
lelecommulrng and gives you the straight 
scoop on how lo make it work tor you. 
Whether you're a telecommuter, a 
telecommuter's boss, or just curious. The 
Underground Guide lo Telecommuting will 
give you the tools and information you 
need lo turn electricity and a phone tine 
into major productivity 424 M $ 22,45 

The Elements of E-Mail Style by 

Brent Heslop and David Angel I. Learn Ihe 
rules ol Ihe road in the e-mail age. 200 
pages, mm $ 13,45 

E-Mail Essentials by Ed Tittel & 
Margaret Robbins is a hands-on guide to 
the basics of e-mail, the ubiquitous 


80 


Mail Order Store 


Ma<Tec;hMaca2ine • February 1996 







Ward more product info? Cad us at 805/494-9797 * ii-mail us at product!nfo<&xf)tain.com 
Or for complete product info t see the MacTecb Web" site at hitp://wum\ maciecb, com 



BOOKS ETC. 


riel works communication system The 
book is suitable for both the casual e- 
mailer and the networking professional, as 
it covers everything from the installation 
of e mail to the maintenance and 
management of e-mail hubs and message 
servers 250 pp $22,45 

The Computer Privacy 
hot Handbook is a practical 
ITEM! guide to e-mail encryption, 
data protection, and PGP 
privacy software With millions of e- 
mail messages and on-line discussions 
exchanged dally on the Internet, 
electronic security has become a key 
concern, the Computer Privacy 
Handbook explains practical steps 
individuals can take to safeguard their 
electronic security i&?4.9-5 $22.45 

PowerPC System Architecture by 

MindShare. This book describes the 
hardware architecture of PowerPC systems, 
providing a clear, concise explanation ol 
the PowerPC specification, the template 


upon which all PowerPC processors are 
designed. The aulhor provides a complete 
description of (he specification for both the 
32- and 64-bit implementations. 656 pages 

mM $31.46 

PCI System Architecture, /w 
Third Edition by MindSharc 
Describing revision 2 1 of the Peripheral 
Component Interconnect (PCI) bus 
specification, this book explores PCI's 
re fair on ship to the rest of the system It 
includes an in-depth treatment of PCI to 
PGi bridges, the PCI BIOS, Ihc 66 MH 7 
PCI bus. and more, 592 pages 
$31.45 

Cyberpunk Handbook, The Real 
Cyberpunk Fakebook by St. Jude, 
R.U.Sirius. and Bart Nagel. Published by 
Random House. This hook tells how to 
fell II you or someone you know is a 
Cyberpunk. WM $8.95 

Planning and Managing Web 
Sites on the Macintosh by 


Weiderspan and Shotten, This book is a 
definitive guide to setting up andrufining a 
Web site on the Macintosh, written by two 
experts in the feild. It skillfully leaches you 
everything you need to know aboul using 
WebSTAR the best known HTTP server 
software and its shareware predecessor 
MacHTtP, as well as about writting CGI 
applications lor your server, A special 
version of WebSTAR, plus ions of useful 
software, arc on the CD-ROM. $35.96 

Sex, Lies and Video /w 
Games by Bill Hensler is written is&ff 
for Ihe wannabe games writer locked 
inside every Mac programmer. This book 
provides a learn-by-exam pie tutorial on 
the ins and nuts ol Mac arcade-style 
game programming in C, It teaches game 
theory, sprite animation, sound, and 
interaction techniques. This hook is a 
must-read for serious programmer's and 
hobbyists alike. $31.46 

Tog on Software Design by Bruce 
Tognazzini. Respected industry futurist, 


Bruce "Tog" Tognazilnl, presents /j*. 
his vision of our technological 
future, detailing the steps computer 
professionals need to lake to deliver new 
technologies lhal will profit the industry 
and benefit society in general This book 
contains Tog's insights on a wide range 
ol topics from quality management to the 
meaning ol standards, and responses to 
queries supplied by designers and 
developers $26.96 

Foundations™ of Mac" 6 yw 
Programming by Dan Parks 

Sydow This all-inclusive tutorial plus 
relerence explains the fundamentals of 
Mac programming, from resources and 
memory management to including sound 
and QuickTime movies. On the CD: 
reusable Example code for Symante C++ 
8.0 or later and Melrowerks Code Warrior 
compilers, plus shareware and public 
domain goodies and a searchable term ol 
fhe book itself. 708 pages, plus one CD- 
ROM. $39.99 


THE APPLE LIBRARY 


Learn C on Late Night 
With MacHack covers thelpfo 
MacHack conferences from their inception 
in 1986. up to 1993 Doug Houseman is 
the program Chairperson ol MacHack, and 
the author of this book. The 
accompanying CD contains over 100 ol 
the hesl hacks written at MacHack over the 
years, including The Grouch, NetBunny, 
Jutassioon Park, DropSavc. QuickTime 
Balloon Help, the Mac Clapper, Wavy, and 
more... $26.95 

Advanced Color Imaging /w 

On the Mac QS explains how 
you can augment the color support 
supplied with Guickdraw. and 
QuiekdrawGX, using the Palette manager 
to provide the best set of colors on 
displays with limited color capabililies, 
sol idling the color choices from users with 
the color Picker Manager/ Using the 
ColorSync manager to match colors 
between screens and input and output 
devices such as scanners and printers/ 
learning how the color Manager assists 
Color QuickDraw in mapping an 
applications color requests to the aclual 
colors available $3 6 -9 6 $33,25 

3D Graphics Program-/^ 
mtng Using QuickDraw 3D w 

by Apple Computer, Inc, Now you can 
incorporate spectacular 3D graphics into 
your applications, this book/CD-ROM 
package explores QuickDraw 3D. a 
graphics extension to the Mac OS for 
Power Macintoshes. The CD contains me 
complete QuickDraw 3D system itsell and 
a complete database of the QuickDraw 3D 


API, allowing you install access to the 
hundreds of graphics calls via a fast 
viewing engine. Book/CD-ROM. 640 
pages W $35.96 

Apple Guide Complete by / 

Apple Computer, Inc For lhm+ 
who want the lull power ol Apple's 
complete toolsel, Itiis bock and CD-ROM 
package from Apple provides everything 
you need to produce guide files 
successfully, including Guide Maker, the 
software you use to build and test guide 
files You'll learn about the complete 
cycle of designing as well as advanced 
topics such as scripting and coding guide 
files. Book/CD-RQM, 544 pages » 
$35.96 

Inside AppleTalk by Gursharan S. 
Sidhu, Richard F. Andrews and Alan B 
Gppenheimer, Apple Computer, Inc. 65(1 
pages. $31,45 

AppleScript Finder 
Guide, English Dialect, by HOT 
Apple Computer, Inc The ITEM! 
AppleScript Finder Guide is 
an essential reference tor anyone who 
wants to use AppleScript on a Mac to 
modify existing Finder scripts or to write 
new ones. The Finder scripting software 
allows you to write, record, or run scripts 
that trigger the same desktop actions that 
you trigger using the keyboard and 
mouse- actions such as opening and 
closing folders or manipulating tiles This 
book introduces Finder scripting and 
describes how to record and modily 
simple scripts In particular, it provides 


definitions tor Finder object classes and 
commands Use of this book requires that 
AppleScript be installed, and you should 
be laminar with AppleScript Scripting 
Additions Guide, and AppleScript 
Language Guide $17.95 

AppleScript language 
HOT Guide, by Apple Computer, 
ITEM! Inc, The AppleScript Lang¬ 
uage Guide is the definilive 
description of the English dialect of the 
AppleScript scripting language I his 
book is an essential reference for anyone 
using AppleScript to modify existing 
scripts or to write new ones It also 
contains useful information for 
programmers who are working on 
scriptablc applications or complex 
scripts This book begins with an 
Introduction to scripting and an overview 
of AppleScript's main features. Most of 
the book consists of detailed definitions 
of AppleScript terminology and syntax in 
the following categories Value classes, 
commands, objects and references to 
objects, expressions, control statements, 
handlers, and script objects In addition 
to definitions the book provides many 
sample scripts and discusses advanced 
topics such as writing command handlers 
tor script applet ions, the scope ol script 
variables and properties declared at 
different levels In a script, and inheritance 
and delegation among script objects To 
gel the most out of this bonk, you only 
need to be familiar with Macintosh 
computers. All hough not required some 
previous experience with another 
scripting language (such as HyperTalk) is 


also helpful, $26.95 

AppleScript Scripting 
Additions Guide, by hot 

Apple Computer, Inc. ITEM! 
AppleScript Scripting 
Additions Guide is the definitive 
description of the scripting additions Itial 
accompany the English dialect ol Ihe 
AppleScript scripting language. Scripting 
additions are files that extend 
AppleScript's capabilities by providing 
the additional commands or coercions tor 
use in scripts. This book is an essential 
reference for anyone using AppleScript to 
modify existing scripts ur wile new ones. 
Jt also contains information for 
programmers who want to write scripting 
additions. The Scripting Additions Guide 
is also a how to install any scripting 
additions and invoke their commands, to 
use fhe standard scripting additions 
commands, or to write scripting 
additions. $17.05. 

HyperCard Stack Design Guide¬ 
lines by Apple Computer, Inc is an 
essentiaI book lor everyone who creates 
Apple HyperCard stacks, from beginners 
to commercial developers. It covers Ihe 
basic principles ol design that* when 
incorporated, make HyperCard stacks 
effeclivB and usable. Topics Include 
guidelines, navigation, graphic design 
and screen illustration, text in stacks, 
music and sound, a sample stack 
development scenario, collaborative 
development, and the Slack Design 
Checklist. 240 pages mM $19.95 
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THE APPLE LIBRARY 


Macintosh Programmer's Toot- 
box Assistant CD-ROM: See page 77 

Inside Macintosh : CD-ROM: See 

page 78 

Inside Macintosh- : Overview by 

Apple Computer. Inc. is the Irrst book tttal 
people who are unlamiliar with Macintosh 
programming should Feed. It gives an 
overview oi Macintosh programming 
fundamentals and a road map to the New 
Inside Macintosh library Inside 
Macintosh: Overview also covers various 
programming loots and languages, 
compatibility guidelines and an overview 
of considerations lor worldwide 
development 176 pages $22£& $20.65 

Inside Macintosh*: Files by Apple 
Computer, Inc describes the pans of the 
operating system that allow you to manage 
files. It shows bow your application can 
handle the commands typically found in a 
File menu It also provides a relereirce to 
the File and Allas Managers, the Disk 
utilization and Standard File Packages 
610 pgs. mM $26.95 

Inside Macintosh*: Operating 
System Utilities by Apple Computer, 
Inc describes parts of the Macintosh 
Operating System that allow you to manage 
various fow-tevel aspects of rhe operating 
system, Everyone who programs the 
Macintosh should read this book! it will 
show you in detail how to get information 
about i he operating system, manage 
operating system queues, handle dates and 
limes, control rhe settings ol the parameter 
RAM, manipulate the trap dispatch table, 
and receive and respond lo low level 
system errors. $2§3fe $23.45 

Inside Macintosh*: Processes 

by Apple Computer, Inc. describes Ihe 
parts ol Hie Macintosh operaling system 
that allow you lo eoulrul Ihe execution of 
processes and interrupt tasks It shows in 
detail how you can use the Process 
Manager lo gel information about 
processes loaded in memory it is also a 
reference lor Ihe Vertical Retrace, Time. 
Notification, Deterred Task, and Shutdown 
Managers. 208pages $3399 $20.65 

Inside Macintosh*: Memory by 

Apple Computer, tnc. describes Ihe parts of 
the Macintosh operating system that allow 
you to manage memory It provides detailed 
strategies for allocating and releasing 
memory, avoiding low-memory situations, 
reference lo the Memory Manager. Ihe 
Virtual Memory Manager, and memory- 
related utilities. 296 pages, $2496 $22.45 

Inside Macintosh*: AOCE 
Application Interfaces by Apple 
Computer, Inc. shows how your application 
can take advantage of the system software 
features provided by Power lalk system 
software and lt>e PowerShare collaboration 


servers. Nearly every Macintosh application 
program can benefit from the add ill on of 
some ot these features. This book shows 
how you can add electronic mail capabilities 
to youi application, write a messaging 
application or agenl. store information in 
and retrieve information from PowerStiare 
and other AQCF catalogs, add catalog- 
browsing and find in catatog capabilities to 
your application, write templates that extend 
the Finder's ability to display information in 
PowcfShare and other AOCE catalogs, add 
digital signatures to files or to any portion ol 
a document, and establish an authenticated 
messaging conned ion S i 40.45 $36.40 

Inside Macintosh: AOCE 
Service Access Modules by Apple 
Computer, Inc, describes how lo write a 
software module thai gives users and 
PowerTa Ik-enabled applications access to 
a new or existing mail and messaging 
service or catalog service. This bonk 
shows how to write a catalog service 
access module (CSAM), a messaging 
service access module (MSAM), and 
AOCE templates that allow a user to set up 
a CSAM or MSAM and arid addresses to 
mail and messages IM $24.25 

Inside Macintosh 5 : Devices by 

Apple Computer, Inc describes how to 
write soli ware I hat interacts with built-in 
and peripheral hardware devices. With 
this book, you'll team how to write and 
install your own device drivers, desk 
accessories, and Chooser extensions: 
communicate with device drivers using 
the Device Manager: access expansion 
cards using Ihe Slot Manager; control 
SCSI devices using SCSI Manager 4.3 or 
the original SCSt Manager: communicate 
directly with Apple Desktop Bus devices: 
interact with Ihe Power Manager in 
battery-powered Macintosh computers: 
and communicate with serial devices 
using the Serial Driver $29.05 $26.95 

Inside Macintosh : Macintosh 
Toolbox Essentials by Apple 

Computer, Inc covers the heart of the 
Macintosh The Inolbox enables 
programmers lo create applications 
consistent with the Macintosh look and 
leer This book describes Toolbox 
routines and shows how to implement 
essential user interface elements, such as 
menus, windows, scroti bars, icons and 
dialog boxes 880 pages $34-99 $31.45 

Inside Macintosh*: More Mac¬ 
intosh Toolbox by Apple Computer, 
Inc. cuvers other Macintosh features such 
as how lo support copy and paste, 
provide Balloon Help, play and record 
sound and create control panels are 
covered in this volume. The managers 
discussed include Help. List, Resource, 
Scraj] and Sound. $3466 $31.45 
Inside Macintosh 1 : Networking 
by Apple Computer, Inc. describes how to 
write software lhai uses AppleTalk 


networking protocols. It describes Ihe 
components and organization of 
AppleTalk and how to select an AppleTalk 
protocol. It provides the complete 
application interfaces lo all Appletalk 
protocols, including ATP (AppleTalk 
Transaction Protocol), DDP (Datagram 
Delivery Protocol), and ADSP (AppleTalk 
Date Stream Protocol), among others. 
W4& $26.95 

Inside Macintosh*: Interap¬ 
plication Communication by Apple 

Computer, Inc, shows how applications 
can work together. How your application 
can share data, request Information or 
services, allow the user to automate lasks, 
communicate with remote databases. 
$34-96 $31.45 

Inside Macintosh*: PowerPC 
Numerics by Apple Computer, Inc. 
describes the floating-point numerics 
environment provided with the first release 
ol PowerPC processor based Macintosh 
computers The numerics environment 
conforms lo the IEEE standard 754 for 
binary floaling-poinl arithmetic. This book 
provides a description of that standard 
and shows how RISC Numerics compiles 
with it. This book also shows 
programmers how to create f teal teg-point 
values and how to perform operations on 
fioaling-point values in high-level 
languages such as C and in PowerPC 
assembly language I38-9& $26.00 

Inside Macintosh*: PowerPC 
System Software by Apple 

Computer. Inc. describes the new process 
execution environment and system 
software services provided with ihe lirst 
version of the system software for 
Macintosh on PowerPC computers. It 
conlains intorrnalion you need to know to 
write applications and other software that 
can run on the PowerPC PowerPC 
System Software shows in detail how te 
make your software compatible with Ihe 
new rurMime environment provided on 
PowerPC-based Macintosh computers It 
also provides a complete technical 
reference for the Mixed Mode Manager, 
Ihe Code Fragment Manager, and Ihe 
Exception Manager $22.45 

Inside Macintosh*: Sound by 

Apple Computer, tec describes the parts 
of the Macintosh system software that 
allow you Io manage sounds It conlains 
information that you need to know to write 
applications and other software that can 
record and play back sounds, compress 
and expand audio date, convert lex! to 
speech, and perform other similar 
operations $36-96 $24,25 

Inside Macintosh*: Text by Apple 
Computer, Inc. describes how to perform 
text handling, from simple character 
display to multi-language processing The 
Font, Script, Text Services, and Dictionary 


Managers arc all covered, in addition lo 
QuickDraw Text, TextEdit, and International 
and Keyboard Resources $3495 $35.95 

inside Macintosh : Imaging by 

Apple Computer, Inc covers QuickDraw 
and Color QuickDraw. The book includes 
general discussions of drawing and 
working with color. It describes the 
structures that hold images and image 
information, and the routines lhal 
manipulate them It also covers the 
Pal site, Color, and Printing Managers, 
and Ihe Color Picker, Color Matching, 
and Picture Utilities M $24.25 

Inside Macintosh*: QuickDraw" 
GX Graphics by Apple Computer, tec 
shows readers how to create and 
manipulate Ihe fundamental geometric 
shapes ol QuickDraw GX fo generate a 
vast range of graphic entitles. It also 
demonstrates how to work wilh bitmaps 
and pictures, and specialized QuickDraw 
GX graphic shapes $39-39 $24.25 

Inside Macintosh : QuickDraw" 
GX Objects by Apple Computer, Inc. 
introduces QuickDraw GX and its object 
structure, and shows programmers how 
lo manipulate objects in all lypes of 
programs. $ 36.95 $24.25 

Inside Macintosh*: QuickDraw" 
GX Environment and Utilities 

A companion to QuickDraw" GX Objects, 
lies book contains programming 
information useful lo any developer 
writing QuickDraw GX applications. It 
describes QuickDraw GX memory 
management, error handling, debugging, 
and mathematical functions, as well as 
conversion from QuickDraw fo QuickDraw 
GX. $» $26.95 

Inside Macintosh*: QuickDraw 
GX Library by Apple Computer, Inc. is 
the powerful new graphics architecture for 
the Macintosh. Ear more than just a 
revision of QuickDraw, QuickDraw GX is a 
unified approach lo graphics and 
typography that gives programmers 
unprecedented flexibility and power in 
drawing and printing all kinds of shapes, 
images, and text, 

Inside Macintosh: QuickDraw" 
GX Printing This book is essential lor 
any developer whose QuickDraw" GX 
application supports punting. It shows 
how to support the new printing features 
of QuickDraw GX, including desktop 
printers and expandable printing dialog 
boxes. QuickDraw GX Printing also 
shows how to use printing-related objects 
to add custom panels lo printing dialog 
boxes and to create custom page formats. 
$26-99 $24.25 

Inside Macintosh*: QuickDraw" 
GX Printing Extensions and 
Drivers Any developer who wants to 
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create extensions to the application 
printing capabilities ol QuickDraw" GX, or 
who needs lo write a printing device 
driver that works with QuickDraw GX 
needs this book. QuickDraw GX Printing 
Extensions and Drivers describes how to 
create printing extensions and printer 
drivers, and provides a complete 
reference to the messages, functions, and 
resources that they use. $ 3005 $26.95 

Inside Macintosh : QuickDraw' 
GX Programmer's Overview - This 
book provides an introduction to 
QuickDraw™ GX, providing an overview of 
the QuickDraw GX environment from a 
developer's perspective. It introduces the 
QuickDraw™ GX programming and runtime 
environments, the relationship between 
QuickDraw GX and the rest of the 
Macintosh'"systems software and the 
relationship between QuickDraw GX aid 
Macintosh applications. The key elements ot 
QuickDraw GX programming, data 
structures, object types, and functions used 
most frequently by QuickDraw GX 
developers are also covered. After a genera! 


introduction, this book provides readers with 
a series of practical examples demonstrating 
how to approach programming with 
QuickDraw GX. mM $22.45 

Inside Macintosh L : QuickDraw" 
GX Typography - This book is 
essential for any developer who uses 
QuickDraw* GX to manipulate text. It 
shows how to rise QuickDraw GX objects 
lo handle all kinds of lexl - horn plain, 
unstyled lexl to complex, mixed’direetton 
and multi-language text with 
sophisticated stylistic and typographic 
variations. QuickDraw GX Typography 
shows how to create and manipulate the 
three different types of lexl shapes 
supported by QuickDraw GX including 
text shapes, glyph shapes, and layout 
shapes mm $26,95 

Inside Macintosh : QuickTime 

by Apple Computer, Inc. is for anyone 
who wants lo create applications that use 
QuickTime, the system software that 
allows the integration of video, animation, 
and sounds into applications. This hook 


describes all ot the QuickTime Toolbox 
utilities In addition, it provides the 
information you need to compress arid 
decompress images and image 
sequences $26.95 

Inside Macintosh®: QuickTime 
Components by Apple Computer, 
Inc.covers how to use and develop 
Quick t ime components such as image 
compressors, movie controllers, 
sequence grabbers, and video digitizers, 

mm $31.45 

Inside Macintosh : X-ftef by Apple 
Computer, Inc. is a fast access to ail the 
information in inside Macintosh, inside 
Macintosh X Ref; Provides programmers 
with a quick and easy way to find the exact 
information they need in this definitive suite 
ot hooks, (ail 26 volumes). If is indexed by 
topic, volume, chapter, and accompanying 
page number, mm $17.95, 

Inside the Macintosh Com¬ 
munications ToolBox by Apple 
Computer. This book Is the definitive 


reference to the Macintosh Common 
ications Toofbox, an integral part o! the 
System 1 Macintosh Toolbox that enables 
developers lo create communications 
applications or add communications 
features to other applications.This book 
describes alt of the routines that provide 
programmers with standard access to 
important communications services and in 
addition enables programmers to extend 
the reach ot the Macintosh into non-Apple 
environments. $£4-9§ $22.45. 

Open Doc Programmer's Guide 

by Apple Computer, Inc, This is the 
official reference for the implementation 
of GpenQoc on the Mac OS. The book 
describes the component software 
revolution and explains how fo develop 
for it on the Mac QS platform An 
accompanying CD-ROM contains a 
complete reference to the QpenDoc 
programming interface, and an extensive 
collection of tested, reusable sample 
code $40.46 


EDITORS/DEVELOPMENT ENVIRONMENTS & LANGUAGES 


B&Edlt3.1: Seepages 

CMaster 2.0 by Jersey Scientific 
installs into THINK C 5 / 6 / 7 and 
Symantec C++ for Macintosh, and 
enhances the editor. Use its function popup 
to select a function and CMaster takes you 
right to it. Olftcr features include multiple 
clipboards and markers, a Function 
Prototypes and a GoBack Menu which can 
take you back to previous editing contexts. 
Almost ail features biddable lo the 
keyboard, along over a hundred keyboard" 
only features like "Add New Automatic 
Variable.'’ Glossaries, AppleScript and 
Too I Server support, Macros, and External 
Tools you create loot $729.95 

QUED/M 2.7 by Nisus Software, is a 
programmer's text editor which has delined 
the industry standard tor speed and 
efficiency. With integrated support for 
Symantec C/C++. Meiiowerks 
CodeWarrior 6, and MPW, OUED/M otters 
unrivaled usefulness for the Macintosh 
developer. In addition to supporting all the 
major development environments on the 
Macintosh, QUED/M offers dozens of 
powerful editing features, including 
unlimited undo and redo, UNIX style GFtEP 
searching, macro language, scripting, text 
folding, text sorting, file comparison and 
merging, Toolbox lookup, len 
edilable/appendable clipboards, line 
numbering, markers, displaying lexl as 
ASCII codes, vertical and horizontal screen 
splitting, plus much more. $149 


CodeManager™ 1 Microsoft- /g. 
Visual SourceSafe™ 4.0 compatible 
source code control system lor the 
Macintosh 1 - $399. Call tor more into. 


SYMANTEC J 


Symantec C-h- See page 71 

THINK Pascal v. 4.0 by Symantec 
Corporation. Professionals and students 
will welcome this version of THINK Pascal. 
It is fully integrated lor rapid turnaround 
time and lets you take advantage of System 
7 capabilities. Features include support for 
large projects, enhanced THINK Class 
Library. System 7 compatibility, superior 
code generation, and smart linking. Product 
Contents: Four Macintosh disks, a 562- 
page user manual, and a 498-page object- 
oriented programming manu^^^ $169 

IS Object Pascal CD includes the 
world's first Object Pascal compiler tor 
Power Macintosh. 100% compatible with 
Apple’s MPW Pascal, LS Object Pascal 
combines the best of Apple's native 
development tools with innovative new 
technology developed at Language 
Systems. Compiler options specify 68K or 
native PowerPC code generation. Included 
on the CD are: LS Object Pascal compiler. 
Universal Pascal Toolbox interfaces, fully 
loaded MPW 3.3.1, 68K and PowerPC 
source debuggers, PowerPC assembler, 


online documentation, Macintosh Tech 
Notes, and a special version of AppMaker 
hy Bowers Development that generates 
native Pascal source code. The beta 
release Includes upgrades to vl.O when it 
becomes available. $399 


tPA MacProlog comprises a 
Edinburgh syntax Prolog compiler system 
set in an attractive multi-window 
development environment with an 
integrated program editor, graphical call- 
graph facilities and an interactive source 
level debugger. LPA Mac Pro lug features 
high-level access lo the Macintosh 
ToolBox for using graphics, dialogs, 
windows, icons, resources in a simple and 
versatile way LPA MacProlog also includes 
interfaces to C and Pascal code resources. 
The MacProlog Run-time Generator 
enables the production ol double-clickable 
distributable appiica-lions. The compact 
run-lime system supports first argument 
Indexing, tail-recursion and last-call 
optimization. Optional add ons tools 
include flex, Prolng++, MacDBI tor Oracle 
and The MacProlog Dialog Editor. 
Programmer Edition $745; Developer 
Edition (which includes the run-time 
generator and distribution license) $1500 


SmalltalkAgents <STA) is a 

I n 1 / 0 sophisticated 
K \ application development 
environment featuring a 


new generation of the Smalltalk language, 
OKS Smalltalk™. Productivity Is no longer 


measured in lines of code, but in project 
completion time. SI A allows "live" direct 
manipulation of your objects. The 
development process is dynamic, 
interactive and iterative. Just like C/C++ 
and Assembly, STA provides easy and full 
access to tho features of the MacOS™ and 
Mac Toolbox, You can link your non- 
Smalltalk code resources using our 
External Code Linking Toolkit™ (ECLT). 
You can also call back into STA from 
foreign functions written in C/C++. Pascal, 
FORTRAN, and Assembly. STA s 
automatic garbage collection and object- 
based typing will free you from tedious 
memory management and bookkeeping 
chores. A sophisticated database for 
source code management provides an 
almost infinite variety nt ways to cross- 
reference, access, view, and manipulate 
youi code and objects. STA includes an 
Application Delivery Toolkit™ (ADT) that 
allows you to create royalty-free, stand¬ 
alone, double clickable applications In 
just a matter ot minutes. The foundation ol 
the QKS Product Family, the Agents 
Object System (AO/S), is an underlying 
task framework, housing components and 
services that save you years of work. Any 
component built in AQ/S will function as 
an QpenDoc component or container and 
components irom non-AO/S sources can 
be seamlessly integrated into the AO/S 
system. Smalltalk Agents List Price: $695. 
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ICONIX PowerToals by 

ICONIX has been a leadinqlpffi 
supplier of CASE louts, since 1984. One 
of itie first Object-Oriented CASE loo! 
developers, ICONIX is known throughout 
the Industry for producing affordable, 
high-quality loots and state-of-the-art 
training. Our line of Object-Oriented 
Analysis and Design tools, ICONIX 
PowerTools, is an inlegrated set of 10 
CASE tools supporting the major phases 
of the system development life cycle and 
automating analysis, design, coding, and 
the management of complex systems. 
ICONIX is unique because we are the first 
to bundle CASE tools, CD-ROM training, 
and on-site training and consulting Each 
Individual module is $1,495. PowerPack 
Bundles: Choose any 6, 8 or 10 distinct 
modules ol your choice lo customize your 
own ICONIX PowerTools toolset. Our 
professional sales stall will gladly assist 
you in choosing the right loots for your 
project's needs, PowerPack/6: £5,995 
Power Pack/8: $6,995 PowerPack/10: 
$7,995. (Full Product Line) Call for 
pricing on Upgrade Service & Training 
and Consulting. 

Voodoo Is a version control tool tor the 

uooddo s ' m P |e ^ cEear maria 9 e 

™ ment ol projects in which 

j= jT files are created In 

numerous versions 
(variants and revisions). 
Voodoo allows both variant and revision 
control, and it manages not only variants 
and revisions ot single files, but of a whole 
software project (multi tiles, multi users, 
multi variants, access rights,...). The too! 
offers a neat graphical user interface and is 
not only suitable lor mere source code 
control but can handle all 
HOI different kinds of tiles with 
TOM! amazing compression rales: 
typical size of delta between 
arbitrary files 5% (in words: five per cent) 
III! no matter whether the fifes are plain text 
or any other documents - e g.. MSWord, 
4D, Canvas, FileMaker... Please note 
special prices for multiple copies: single 
license $190; 2 pack $300: 5 pack $665; 
10 pack $1140; 20 pack $2000 Add’l 
pricing available on request. 


PROFILERS/ 

DEBUGGERS 


LJ Profiler by Lars Jnrdebo 
Daiakonsul! supports profiling ot C++ 
68 K and PowerPC applications compiled 
with CodeWarrior 6, CFront or Symantec 
C++. Based on active profiling, i,e. 
profiling code called at function enter and 
exil, the browser application lets you 


follow call chain timings in hierarchical 
views or separate windows. Collect, 
organize, compare and save proving data 
from different versions of your application 
Into a project. Scrlptahle and recordable 
with full access to mosl internal data 
structures, Optional remote profiling and 
tracking ot segment and stack usage. Full 
source code to what you link into your 
application, $295, 

Last Resort Programmer's 
Edition records every keystroke, 
command key and mouse event (In local 
coordinates) to a file on your hard disk. 
This is especially useful for program 
testing & debugging, and for technical 
support and help desks. If something 
goes wrong (because ot a power failure, 
system crash, forgetting to save or 
deleting lines) and you lose a word, 
phrase, or document you can look in the 
Last Resort keystroke file and recover 
what you typed. Last Resort is also useful 
for technical support personnel, when 
they have to ask "What was the last thing 
you did before...?" $74.95 

QG" by Onyx Technology. See page 69 
The Memory Mine" by Adianta is a 

stand atone debugging tool for Macintosh 
and native PowerPC. Programmers can 
monitor heaps, identify problems such as 
memory leaks, and stress test appli¬ 
cations. Active status of memory in a 
heap is sampled on the fly; allocation in 
non-reJocatable (Plr), relocatable (Han¬ 
dle) and tree space is shown, as are heap 
corruption, Iragmentalion, and more .. 
Allocate, Purge, Compact, and Zap 
memory let users stress test all or part ol 
a program Source code is not needed to 
view iieaps. It works on Macintoshes with 
68020 or later arid System 7.0 or later. 
£99 

Spyer hy ladder is a simple operated 
tool that records all actions (including 
mouse movement) you perform on a 
Macintosh computer and then 
replays them at your preferred speed. 
The recorded data can be saved in files 
for future use Spyer works as a 
background process with any Macintosh 
application and is triggered by user 
defined Hot Keys. Spyer enables the 
"Continuous Redo" utility and is 
especially useful lor software testing and 
demonstration. $39 


INSTALLER TOOLS 


Installer Pack™ by StopUp Software is 
a package of several Installer "atoms" that 
let developers incorporate graphics, 
sounds, tile compression and custom 
folder icons into installation scripts. 
Compression formats supported are 
Compact Pro & Diamond. Each atom also 
available separately. Compression 


requires additional licensing. $219 

ScriptGen Pm'" hy Stepllp Software 
is an Installer script generator which 
requires no programming or knowledge 
of Rez. Supports StepUp's InstallerPack, 
Stuff!! compression, custom packages, 
splash screens, network installs, Re? code 
output, importing resources, and 
AppleEvenL link w/MPW: $169 


fully portable cross all supported 
platforms. Th ird-party vendors supporting 
otF will be able to otter a variety of 
advanced features and benefits to their 
customers royally free. Tools are included 
for importing, exporting, creating and 
managing databases and users. 
Supported development environments 
include: Symantec, MPW, Metrowerks 
and more. Mac/SDK $695 


LIBRARIES/ 

FRAMEWORKS/ 

DATABASES 


OOFILE See page 76 
PowerTap" See page 76 

30 Game Machine vl.2 by 

Virtually Unlimited is a C library lor 
creating lightning-fas! 3D arcade games 
and interactive multimedia applications. 
3DGM has a simple easy-to-use Interface 
and features very fast rendering (15 
Itames per second on a 14" monitor 
completely texture-mapped, with a 
PowerMac 6100/60), full "virtual" 3D 
worlds with six degrees of freedom, free¬ 
form texture mapping, shading, material 
and light properties, convex/cave 
polygons with unlimited vertices, 
unlimited light sources, dynamic hidden 
surface removal, special graphic modes 
lor fast full-screen animation, collision 
detection, explosion simulation, 3D data 
importing. Runs on atl Macs! Works with 
CodeWarrior. $299 + license. 

Animation Glass Library version 

2,0 (ACL2.Q) is an advanced object- 
oriented multimedia framework, allowing 
fast development of high quality 
interactive applications. Main features of 
ACL2.D are: Powerful animation engine 
which supports structured sprites, 
collision detection at pixel precision, 
sprites sorting, powerful blitter and vector 
objects. Scrolling of background picture 
in circular buffer and tile-mapscrolling. 
Application framework for building 
standard and 3D controls, panes,menus, 
full screen displays, windows, etc. 
Quicklime and multi-channel sound 
support. >800 functions and >100'000 
lines. Complete C++ source code for 
CodeWarrior and Symantec C++, 
examples, documentation and technical 
support $250 

dtF is a true relational database system 
for Apple Macintosh computers. dtF 
provides a powerful choice for developers 
who want to create database centered 
applications with no performance trade¬ 
offs. dtF features SQL, full transaction 
control, error recovery, single user, client 
server architecture and multi-platform 
support including DOS, Windows, OS/2 
and UNIX The C/C++API is identical and 


MacWireFrame by 

Amplified Intelligence. 
Create your own virtual 
reality application with 
MacWireFrame, a virtual reality 
application frame work. Includes a 
complete Library ol object oriented 
graphics routines, its own easy to 
understand application frame work 
(simitar to MacApp or TCL but a lot easier 
to understand), plus an example 
application program that lets you start 
solid modeling right away Comes 
complete with fully documented source 
code, All new purchases will be 
guaranteed a $49.99 upgrade to the soon 
lo be released, scriptable, MacWireFrame 
5.0, Due lo the overwhelming response 
the special price offer has been extended 
for a little while longer Special Offer: 

$75i!ii 




1 /— V 


PictureCDEF 

1.3 by Paradigm 
Software is a 
professional-level CDEF for creating 
custom graphical buttons (8-64 pixels) 
PictureCDEF Is used in products by 
Adobe, ProVue, STF Tech- 
Hot oologies and others, it is 
ITEM! multi-monitor and bit-depth 
sensitive. The button graphic 
(cicn, ResEdit) can be changed at runtime 
and even animated with a call-back 
routine. Create distinct buttons in seven 
variations: MulliStale. Pushbutton, 
FlexiButtom ToggleButton, ChkBulton, 
PushPictButton and ToggiePicEGutton. 
Position the optional buttnn title at left, 
bottom or right, or follow the system text 
direction lor international support. 
Manual, sample code and MacApp 3.0 
support included. Full source code- 
$95.00 Object code: $45.00 


Q3S/3dPane/SmartPane source 
code bundle by Vivistar Consulting. Q3S: 
source code bundle from ViviSlar 
Consulting. Full featured 3d graphics. 
Points; lines; polygons; polyhedra; 
Gourarid shading; z-buflering; culling; 
depth cueing; parallel, perspective, and 
stereoscopic projections; performance 
enhancing "OnlyQD" and '’Wireframe" 
modes; full clipping; pipeline access; 
animation and model interaction support; 
and a "triad mouse" to map 2d mouse 
movement Id 3d 3dPane provides 
Integration with I he TCL and provides a 
view orientation controller. SmartPane 
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provides TCL onscreen Image buffering, 
flicker tree animation, and QuickTime 
movie recording. SmarlPane lundions in 
3d or 2d scenarios Ml work with C++ 
compilers or ThinkC 6 and compile to 
PowerPC or 68K target machines $192 

Spellsweli 7 1.0.4 is an award 
winning, comprehensive, practical spelling 
checker that works in batch mode or within 
applications that incorporate the Apple 
Events Word Services protocol (e,g, 
Eudora, WordPerfect, Communicate!, and 
Fair Witness), Spellsweli 7 checks for 
spelling errors as well as common typos 
like capitalization errors, spaces before 
punctuation, double double word errors, 
abbreviation errors, mixed case errors, 
extra spaces between words, a/an before 
vowel/consonant, etc,., MacTech orders 
include developer kit with Wnleswelt Jr., a 
sample Apple Events Word Services word- 
processor and ils source code $74.95 


StoneTable Extra: Additional 
functions for StoneTable Drag selected 
cells within table or to other lables; 
optionally add rows as part of drag, popup 
menus or check boxes in cells: variable 
width grid lines: move/drag/resize table in 
window, clipboard operations on multiple 
cells Requires StoneTable, (all prices per 
developer) $50 first compiler, additional 
compilers $25. 

StoneTable: A library replacing all 
functions found In fist manager plus- 
variable size columns/rows; different font, 
size, style, lofecolor. backcolor per cell; 
sort, resize, move, copy, hide 
columns/rows: edit cells/tllles in place, 
titles for columns/rows: multiple lines per 
cell; grid tine pattern/color, greater lhan 
32k data per table, up to 32k text per cell, 
support tor bat loon help and binary cell 
data. Versions for Think C. Think Pascal, 
MPW 0. MPW Pascal, CodeWarnor 6 C 


(ail prices per developer) $150 first 
compiler, addilional compilers $50 

StoneTable and StoneTable- 
Extra for PowerPC: Same function 
alily as G8K libraries. Versions for MPW 
C and CodeWarrior 6 C. Must have 68K 
libraries, (all prices per developer) 
StoneTable $100, SloncTableExtra $25. 

B-Tree HELPER™ 2.2 [s an 

inexpensive database engine for 
Macintosh programmers in C source 
code B-Tree HELPER gets space in a file 
in contiguous fixed length blocks. It 
expands the file as necessary and 
contracts files when possible. B Tree 
HELPER inserts and deletes keys in one 
or more 8-Trees. If finds keys equal to, 
Jess than, or greater than a given value in 
a tew hundredths of a second. It finds 
lists of records whose keys are equal to, 
less than, or greater than a given value or 


are in a range of values. $150 

AppMaker makes it tester and easier 
lodevelop the user interface for a 
Macintosh application Just point and 
click to design your application, then 
AppMaker creates resources and generates 
excellent source code. AppMaker supports 
most development environments Including 
Metrowerks, Symantec, or MPW; C. C++, 
or Pascal; procedural or object-oriented, 
using PowerPtent, TCL, or MacApp. The 
generated code uses the Universal Headers 
to provide PowerMac compatibility. 
Beginners use AppMaker to learn object- 
oriented and Macintosh Toolbox 
programming techniques Experts use It to 
increase productivity. It saves so much 
lime it's like having your own assistant 
programmer working for you. Includes 
one-yea: SubSCfiplion on CD $299 


SCRIPTING/SYSTEM ADMINISTRATION 


ScnptWizard See page 78 

FaceSpan" v2: See page 77 

DataScript DataScript Is probably he 
quickest, easiest and most cost-effective 
way to make your integrated AppleScript 
solutions database aware today 
Quickest: It takes just six hues of 
AppleScript to make new or existing 
scripted solutions database aware, and 
fetch data from RDBM's such as Oracle, 
Sybase. DB2. m Informix Easiest: 
DataSeript's scripting terminology is easy 
to learn, easy to use, and easy to 
remember "Inside DaiaScripr contains 
lots of easy to follow scripts to reuse in 
your own solution Cosl Elective: 
Because DataScripl is so easy to learn, 
and use you'll become productive very 
quickly, and once you're ready to ship, 
you'll find our licensing schemes very 
attractive, $249,00 

Scripter: See page 77 

C LI mate by Orchard Sol l ware is a 
command line interface ihal lets you 
communicate with your Macintosh using 
English commands to create, delete, 
rename, and move liles and folders It can 
Start applications, format disks, restart 
your computer, etc CLImale supplements 
the Finder. It includes a BASIC interpreter 
that lets you script your Macintosh 
without AppleScript The interpreter 
includes advanced programming 
constructs: repeat loops, It/then/efse 
conditionals, subroutine calls, etc.., 
CLImatc implements wildcard characters, 
enabling you to work on groups of files 


Use Climate instead of MPW to manage 
your projects Cl imate is an application 
occupying 70K disk space It comes 
bundled with sample programs and full 
documentation. $59.95 

Cron Manager by Orchard Software 
implements (be UNIX Cron facility. It can 
open any Macintosh file on a given dale 
and lime. By creating an alias, renaming It 
to the date and time to open, and moving 
it into the special Cron Events Folder. 
Cron Manager will open it. Cron Manager 
is a control panel lhat creates the special 
Cron Events Folder inside your System 
Folder. If is completely transparent to the 
user. It works like the Startup Items lolder, 
only smarter. It works with any Macintosh 
file: if you can double-click to start it. 
Cron Manager can open it $26 95 Cron 
Manager bundled with Climate, $5995. 

Rosanne™ Rosanne is a collection of 
utilities which offer the user complete 
control over raw data. Users can sort files, 
extract selected records, summarize 
frequency counts, create sample files, 
perlorm matching on multiple files, and 
relorrnal date to new specilications, all on 
the desktop, and even on files of a million 
records or more. The Rosanne Utilities 
also support AppleScript™, enabling the 
user Id link several actions together to 
complete an entire process, The Rosanne 
Utilities are recordable; users may 
perform a series of actions, and using an 
AppleScript editor such as Scripter™. see 
Ihelr actions translated directly into 
AppleScript commands All of the utilities 
support multi-tasking and background 
processing. The Rosanne Utilities will 


assist you in picking your specifications, 
determining record length, creating 
output files and managing the storage of 
data Rosanne Utilities: Copy - 
duplicates an Input life. Format 
creates an altered version of an input file, 
containing either subsets of the fields on 
the inpul file, or new fields. Select - 
creates a subset of the records on an 
Input file based on some selection 
criteria. The Recode option allows the 
user to group data, or correct coding 
entries. Sort - orders an input tile by a 
particular field or set of fields Match - 
joins together two input files based on 
common values occurring in 
corresponding lields or sets of fields 
Aggregate - creates an output file with 
summary levels, $595 

ScriptBase™ The Scripting 
Datanase is a database for storing 
persistent objects to be made available for 
access to AppleScript, Apple's system 
level user scripting language tor 
controlling applications on Macintosh* 
computers Once installed, the database 
becomes part ol the AppleScript system, 
adding a host ol commands to the basic 
AppleScript vocabulary. Retrieving the 
objects is simple using AppleScripts 
natural-language syntax and structure. 
Objects stored and retrieved to ScriptBase 
can be accessible any time from any 
script on the user's computer These 
objects can be of any type, including 
numbers, character strings, lists, records, 
scripts, and references to disks, files, 
folders, as well as abstract raw data, lo 
name just a tew ScriptBase can be used 
to maintain system-wide sellings, such as 


sets ol preferences, paths to frequently- 
used liles or folders, Complex 
installations can he made easier by 
organizing data and scripts within the 
database's structure. $79 

Script Debugger by Late 
Night Software Ltd is a hqj 
powerlul and flexible ITEM! 
AppleScript authoring tool. 

Script Debugger makes it 
simple tor novice and experienced script 
writers to get the most from AppleScript. 
The program s advanced debugging 
environment offers single-step script 
execution with breakpoints. The Scripl 
Debugger dictionary browser features a 
graphical view of objects provided by 
scriptablfi applications With the program, 
you also receive the Late Night Software 
Scripting Additions, a collection ol more 
than 70 new AppleScript commands, and 
Scheduler, a utility that allows you to launch 
scripts at pro-determined times. $129 

TCP/IP Scripting 
HOT Addition" is the latest 
ITEM! version of an award-wirming 

AppleScript scripting addition 

(first place in the 1994 "Best 
Hack" category in the Everyday AppleScript" 
Programming Competition). This scripting 
addition (or osax) allows you lo write 
scripts using MacTCP" commands in 
AppleScript" Potential uses of this include 
sending email or files through a script, 
checking if users m logged on (via Finger), 
automating HP, Gopher, NelNews, Telnet, 
and LPR, verifying links in HI ML 
documents, and quickly writing many other 
TCP/IP client-server programs Sample 
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SCRIPTING/SYSTEM ADMINISTRATION 


scripts are included already implementing 
many of these functions Wh m combined 
with FaceSpan, the potential for rapid 
implementation of Internet client-server 


applications is enormous. The TCP/IP 
Scripting Addition works wild AppleScript 
10 Of later and MacTCP 2.0.1 or later. It is 
compatible with Open Transport" The 


TCP/IP Scripting Addition can be used from 
Script Editor, HyperCard 2.2, MacPERL, 
FaceSpan and other Open Scripting 
Architecture applications. See "blip:// 


wmma ngotT(£.(2XTi/b^ 

' lor more details. $49 


MACTECH EXCLUSIVES/MISCELLAIUEOUS 


MacTech Magazine is your exclusive 
source for these specific products 
including available back issues of 
SFA’s magazine , source code disks 
and assorted cd’s. Cali for more info 
and pricing: 

Ad Lib 2.0 The premier MacApp 3.0 
compatible ViewEdit replacement. A 
powerful user-interlace editing tool to 
build views tor MacApp 3 0 and 3,1. Ad 
Lib allows subclassing of all of MacApp's 
view classes including adorners. 
behaviors, and drawing environments. 
String and text style resources are 
managed automatically Alternate display 
methods, such as a view hierarchy 
window, allow easy examination ol 
complex view structures. Ad Lib includes 
source code for MacApp extensions that 
are supported by the editor buttons can 
be activated by keystrokes, behaviors can 
be attached to the application object, and 
general purpose behaviors can be 
conligured to perform a number ol useful 
functions, Run mode allows the user to 
try out the views as they will work in an 
application Templates can be created to 
add additional date fields to view classes. 
Editing palettes provide last and easy 
editing ol common objects and attributes 
Works with ACEs Object Master (version 
2.0 and later) to navigate a project's user 
interface source code. $195 

Frameworks Magazine: $8/back- 
issue, subject to availability. 

FrameWorks Source Code Disk: 

$10 per back issue, siihjed to availability. 

Five Years of Objects CD-ROM: 

Frameworks archives and source code 
Irom April 1991 to January 1993. plus 
selected object-oriented publicly available 
software and demos. $95 

MADACON ’93 CD-ROM; The 

highlights ol MADACON '93, including 
Mike Polel on Pink, Bedrock, MacApp, 
QODLs, and more Slides, articles, 
demos, audio, and QuickTime. $95 

MAScript 1.2 adds support lor 
AppleScript to your MacApp 301 and 31 
based applications Make your application 
saiptabie and recordable by building on a 
tried and tested framework tor object 
model support MAScript dispatches 
Apple events to the appropriate objects, 
creates object specifiers, and makes 


framework objects like windows and 
documents scriplable and recordable 
Sample application shows you how to 
begin adding support tor scripting and 
recording, MAScript includes complete 
source code Install MAScript by 
modifying one MacApp source lile, then 
adding another to your project. Future 
versions of MacApp will incorporate 
MAScript, so MAScript support you add 
now will work in the future. $199 


The Mjelner BETA System is a 

software development environment 
supporting object-oriented programming 
in the BETA programming language 
BETA is uniquely expressive and 
orthogonal. BETA unifies just about every 
abstraction mechanism including class, 
procedure, function, coroutine, process 
and exception - into the ultimate 
abstraction mechanism: the pattern, 
BETA includes; general block structure, 
strong typing, whole/part objects. The 
compiler; binary code generation, 
automatic garbage colled ion, separate 
compilation, interlace to C, Pascal, and 
assembler The system; persistent 
objects, basic libraries with containers 
classes, plailorm-iodependenl GUI 
application frameworks on Unix, Mac and 
Windows NT, metaprogramming system 
The tools available on Unix the hyper 
structure editor supporting syntax 
directed editing, browsing, etc., and the 
source code debugger are currently being 
ported to the Macintosh system The 
M joiner BETA System tor Macintosh 
requires MPW (basic set) 3 2 or later 
Package containing compiler, basic 
libraries, persistent store, GUI framework, 
and comprehensive documentation 
(Other packages are also available) $295 

More Savvy includes all Savvy features 
plus Apple Event support tor all sub¬ 
classes of TEvenlHandler with extensive 
view support. Apple Event support tor text 
includes text attributes and sub range 
specification. Rccordability supports 
additional actions, and cnerann includes 
additional types Additional client and 
server Apple Events, $450 


Savvy 1,1 QSA support includes 
lattachability, readability, 
scriptability, coercion, in 
I addition to script execution, 
idling anti i/o. Apple Event supporl 
includes complex object specifiers, 
synchronous/asynchronous Apple Event 


handling, and Apple Event transactions for 
clients and servers. The Core Suite of 
Apple Event objects is supported 
including the application, documents, 
windows, and files. Documentation 
Includes technology overview, cookbook, 
and sample code. $250 Savvy now 
supports MPW 31, 3.11 and continues to 
support 3,01, as welt as supporting 
Metrowerks CodeWarrior This month 
nnly, special offer-All Savvy versions 
include tree copy of Savvy QuickTime! 

Savvy QuickTime Requires Savvy, 
More Savvy, or Super Savvy Includes 
QuickTime. Apple Event, and view 
template supporl. Movies come out ot the 
box ready to play, edit, and read to Apple 
Events. They can be included in any view 
structure, including templates, and are 
displayed in the scrap view Movie 
controls include volume, play rate, 
looping mode, display style, and other 
characteristics. $250 

Super Savvy includes ail More Savvy 
features plus compile, edit, and record 
scripts using buitt in script editor View 
template editors, tike Ad l ib. can attach 
scripts to view objects and modified 
scripts are saved with the document. 
Script action behavior allow quick access 
fur executing and editing scripts attached 
to views Text to object specifier coercion 
plus more. $700 


MISCELLANEOUS 



l BASIC lor the Newton is 

m BASIC tor the Newton! Frnm 
NS BASIC Corporation, it is a 
*««««: fully interactive implementation 
of the BASIC programming language if 
runs entirety on the Newton no host is 
required, II includes a full set ot functions 
and data types, hand written input, 
windows, buttons and extensions to take 
advantage of the Newton environment. 
Applications can create files or access the 
built-in soups. Applications can also 
access the serial port for input and 
output Work directly on the Newlnn, or 
through a connected Mac/PC and 
keyboard, NS BASIC includes a 240 page 
pockel sized manual. Runs on all Newton 
1.x and 2.0 units. $99 


Inside CodeWarrior 8 & Inside 
PowerPlant: Seepage 101 


Guide Composer gives anyone the 
ability to create powerful Apple Guide help 
systems for any new or existing Macintosh 
application. Great tor commercial 
developers, shareware developers, in- 
house developers, and consultants, Guido 
Composer provides a WYSIWYG 
development environment; Guide content 
is developed in Guide windows. Design 
topics, phrases, and panels in the same 
format as the user will use them Features 
are WYSIWYG interface, Topics, phrases, 
and hierarchical phrases, Coach marks, 
Fully-Integrated with Apple's Guide Maker 
(distributed with Guide Composer), 
compiles scripts automatically, PICTs in 
Panels, Generated Guide scripts are 
modifiable, Compiled files are 100% 
Apple Guide-compatible and royalty-tree. 
Easy-to-use $99 

Mach 1 ™ UNIX lor Macintosh and Power 
Macintosh MachTen is a Berkeley UNIX that 
runs on the Classic to the Power Mac, 
including PowerBooks and Duos! So, in 
addition to all of the Macintosh applications, 
you get a Mach-based UNIX with pre¬ 
emptive multi-tasking MachTen extends the 
Macintosh operating system with UNIX 
networking and software development tools, 
tee MacinloshAJNIX integration is so strong 
that you can even use Macintosh programs 
and utilities on UNIX data, and UNIX 
programs and utilities on Macintosh files. 
Full internet protocol support ensures fast, 
easy client and server NFS, e-mail, and file 
transfer between the Macintosh and all TCP- 
based entities on your network Built-in 
Internet services include domain name 
service, POP mail service, internet routing, 
SUP & PPP. and Web service. Full XI !R5 
supporl with Motif for developing X 
applications and a high performance X 
server lor using your Mac as an X terminal. 
MachTen Power UNIX $695, Personal 
Machlen (for G8K Macs) $495 
Professional MachTen (lor 68K Macs] $695. 
MachTen X Window Software $350. 

Roaster DR1“ See page 100 


Geek ware by Metrowerks 

Mousepad $8,95 

Geekware Hawaiian Classic . .. $7 95 

Blood, Sweat & Code Black 

Long Sleeve Shirt .$14.95 

Cross Platform While 
Short Sleeve Shirt ,.$1495 
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TIPS & 
TIDBITS 



Hy Stew Sisal fc, Contributing Editor 




TIP OF THE MONTH 


An HGetState Gotcha 


HGetState dues not return a valid handle state 
when you pass it an empty handle (one whose master 
pointer is NULL). Instead, it returns an error code, so 
before you call HGetState, be sure to check that the 
handle isn'i empty and execute an alternate code path 
if it is. 

I was bitten by this because I was using 
HGetSt ate to determine if a handle was to a resource, 
and the resource had been purged, so HGetState 
returned an emor code instead of the handle flags, and l 
incorrectly decoded the return result and thought the 
handle wasn't Lo a resource. 


An Old Bug, Turns Out to m “An Old Bug” 

I think 1 found a bug in a Tip in the March 1995 issue of 
MacTech magazine. The Tip, entitled "Hot Tip for Hot Keys 11 , Gin 
be found on page 67. Allow me to quote a segment of code: 

else 

t 

am ~ CountDITL( theJ)ialog): 
for(i-0; Kmm; 1++} 
t 

G^tBlteiE (theD i a 1 og, i. &iType* trlHandic, MReet); 

//and su an ... the omitted rode works wonderfully 1 

1 

1 

The problem is that the for loop is counting from 0 to 
Number-Of-DITL-Items minus 1. While the for loop is executed 
the correct number of times, it’s starting and ending one index 
too early. Iliis off-by-one error is relatively common in C. 
Either the for loop should be: 

for (1=1; i<=nuin; t++) 


Brie Scblegel 


Continued on page 70 


From Inside Macintosh: 

Memory, page l-6l to 1-62: 

If an error occurs during an attempt to get the 
state flags of the specified relocatable block, 
HGetState returns the low-order byte of the result 
code as its function result. For example, if the handle 
h points to a master pointer whose value is NIL, then 
the signed byte returned by HGetState will contain 
the value -109- 

Result codes: 
noErr 0 

nilHandleErr -109 NIL master pointer 
memWZErr -1II Attempt to operate on a free 
block 



l^end us your tips or we'll install EwnBetterBusErrof 4 j 
on your machine! On the other hand* ive might just 
way you $25 for each tip we me, nr $50 for Tip of the 
Month. You can take your award in goods, 
subscriptions or US$. Make sure any code compiles, 
and send tips (and where to mail your winnings) to 
our new Tips e ntail address at tipsltmaaech.com. 

See page im for-our other addresses. 
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Building Client/5erver Applications Doesn’t Have to be Painful. 



Get JAM® 7 - a Smashing New Version! 

Whether you are a business analyst or a top-seeded devdoper - J AM 7 makes ft easy to develop and 
deploy industrial-stnrngth applications The newest release of JYACCs industry-leading second 
generation clicritiservEr tool gives you the features and flexibility you need to see complex presets 
successfully through from start to finish. JAM allows you to build client/server applications on the 
Macintosh and deploy them across platforms including OS/2 Warp* Motif. Windows 3.1, Windows 95, 
VAX/VMS, and virtual^ every implementation of UNIX And unlike the competition s runtime-only Mac 
ports, JAM for the Macintosh provides a full application development environment with true Mac 
look and feel. So don't bear the pain of inadequate tools - get JAM and be a winner! 


JAM gets your Macintosh applications up and running with: 

/ Native Mode on Both 6BK and J Access and Native Support for Oracle, 

Power Macintosh Sybase. OP SC and more. 


/ True Mac Look and Feel 

/ Portability to Windows 95, Motif, 
05/2 Warp, and Character-mode 


S Visual Object-based Development Environment 

/ Database Screen Wizard with Full 
Transaction Control 


/ Repository Driven Development 


/ Automatic SOL Generation 


Call 1-600-456-3313 

or E-mail: macjami£ljyacc«com for a free demonstration kit. For international inquiries 
call: 1-212-267-7722 or FAX 1 212-606-6753. Visit our Web site at http://www.jyacc.com. 


PF AJTL [95) II B15 BZ29 * MNHAfp, (451 « JJ ft 5 77 * MW ANIP (*£■} 0 iti 9*5 * f(JU*PE [33) I 4$ *i 49 44 * ailUArir J4B) 4D !• IJJ fl7 a * H*¥AIM* 
[3B5] l 242 111 * IHLPIA ^11) B 219 1 >99 * ISRAEL (nr!*] 3 9iT 9320 • ITALY ($9| 2 25 52 55 2 - MLnttl (S3) 9 ISO 4SCO . tlfftniA (F| ClBl 1934 
tXUUI MfAflPA {9952] *71 <74* ♦ *LMGiM>a*IL (50 220 8J22 * SlOYlNPA {399] 11 1 4flfi 004 . &FAIH (94) 1 mA 1X35 » SWEPfN {*5.1 5 9* ID ID 
SWITZtBUNP (*1J ?■ 991 »*> ■ rWAILAtjD (Ml) 2A13 J£» , THf HflHEBlANEX 7D 320 9214 ♦ UUlfE& MMtVCttU (44) 1T1 114 fcftflD 

JAW .<i 4 ragi'itj*#,* t,,i,JT-Ti.url ,jF JYA££ ( Irit, Oth&r Lr*dCfl14r'liS Jri Lha punpnrtjf ri# tliflpr r-PspFcthPfl 


iMvezxza! 




J Y A C C 

Vtetm# Uw rfflfds dt |*nfexinnrf 

dflwtfepw figr Acr 16 jaw 

























































































































